1. PREPARE
During the second week of each unit, we’ll “walk through” a basic research workflow, or data analysis process, modeled after the Data-Intensive Research Workflow from Learning Analytics Goes to School (Krumm et al., 2018):

Each walkthrough will focus on a basic analysis guided by the social network perspective. This week, our focus will be on preparing relational data for analysis, putting together some basic network descriptives, and plotting a network visualization to help illustrate key findings.
Specifically, the Unit 1 Walkthrough will cover the following topics:
Prepare: Prior to analysis, we’ll take a look at the context from which our data came, formulate some research questions, and get introduced the {igraph} R package for network analysis.
Wrangle: Wrangling data entails the work of manipulating, cleaning, transforming, and merging data. In section 2 we focus on importing network data, converting our familiar data frames into a network object that can be analyzed and graphed, and learn about “simple graphs.”
Explore: In section 3, we calculate some basic network descriptives and learn how to summarize the stats with a sociogram.
Model: While we won’t dig into approaches for modeling network data Unit 3, we will take a quick look at some approaches used in the study guiding this walkthrough.
Communicate: We’ll learn more about communicating key findings next week, but for now will be introduced to the basic components of a data product.
1a. Review the Research
Prior to analysis, it’s critical to understand the context and data sources available so you can formulate useful questions that can be feasibly addressed by your data. In Social Network Analysis and Education: Theory, Methods & Applications, Carolyn (2013) notes that:
the social network perspective is one concerned with the structure of relations and the implication this structure has on individual or group behavior and attitudes
More specifically, Carolyn cites the following four features used by Freeman (2004) to define the social network perspective:
Social network analysis is motivated by a relational intuition based on ties connecting social actors.
It is firmly grounded in systematic empirical data.
It makes use of graphic imagery to represent actors and their relations with one another.
It relies on mathematical and/or computational models to succinctly represent the complexity of social life.
For Unit 1, our walkthrough will be guided by previous research and evaluation work conducted by the Friday Institute for Educational Innovation as part of the Massively Open Online Courses for Educators (MOOC-Ed) initiative.
A Social Network Perspective in MOOC-Eds

Kellogg, S., Booth, S., & Oliver, K. (2014). A social network perspective on peer supported learning in MOOCs for educators. International Review of Research in Open and Distributed Learning, 15(5), 263-289.
Research Context
In the spring of 2013, The Friday Institute launched the MOOC-Ed Initiative to explore the potential of delivering personalized, high-quality professional development to educators at scale (Kleiman et al., 2013). In collaboration with the Alliance for Excellent Education, the Friday Institute launched this initiative with a 6-week pilot course called Planning for the Digital Learning Transition in K-12 Schools (DLT 1), which was offered again in September 2013 (DLT 2). This course was designed to help school and district leaders plan and implement K-12 digital learning initiatives.
Academics, as well as pundits from traditional and new media, have raised a number of concerns about MOOCs, including the lack of instructional and social supports. Among the core design principles of MOOC-Eds are collaboration and peer-supported learning. It is an assumption of this study that challenges arising form this problem of scale can be addressed by leveraging these massive numbers to develop robust online learning communities.
This mixed-methods case study used both SNA and qualitative methods to better understand peer support in MOOC-Eds through an examination of the characteristics, mechanisms, and outcomes of peer networks. Findings from this study demonstrate that even with technology as basic as a discussion forum, MOOCs can be leveraged to foster these networks and facilitate peer-supported learning. Although this study was limited to two unique cases along the wide spectrum of MOOCs, the methods applied provide other researchers with an approach for better understanding the dynamic process of peer supported learning in MOOCs.
Data Sources
MOOC-Ed registration form. All participants completed a registration form for each MOOC-Ed course. The registration form consists of self-reported demographic data, including information related to their professional role and work setting, years of experience in education, and personal learning goals.
MOOC-Ed discussion forums. All peer interaction, including peer discussion, feedback, and reactions (e.g., likes), take place within the forum area of MOOC-Eds, which are powered by Vanilla Forums. Because of the specific focus on peer supported learning, postings to or from course facilitators and staff were removed from the data set. Finally, analyses described below exclude more passive forms of interactions (i.e., read and reaction logs), and include only postings among peers.
For our Unit 1 walkthrough, we’ll take a look at data from the original Digital Learning Transition in K-12 Schools (DLT 1) that was not included in this study to allow for comparisons to the findings in this study. Also, for your independent analysis, you may want to consider working with the DLT 2 data to see if you can replicate some of the findings from this paper!
👉 Your Turn ⤵
Take a quick look at the Description of the Dataset section from the Massively Open Online Course for Educators (MOOC-Ed) network dataset BJET article and the accompanying data sets stored on Harvard Dataverse that we’ll be using for this walkthrough.
In the space below, type a brief response to the following questions:
What were some of the steps necessary to construct this dataset?
What two “node attributes” from the dataset that might be useful for predicting participants who may be more engaged or central to the network? Why did you select those two?
What else do you notice/wonder about this dataset?
1b. Identify a Question(s)
A Social Network Perspective on Peer Supported Learning in MOOC-Eds was framed by three primary research questions related to peer supported learning:
What are the patterns of peer interaction and the structure of peer networks that emerge over the course of a MOOC-Ed?
To what extent do participant and network attributes (e.g., homophily, reciprocity, transitivity) account for the structure of these networks?
To what extent do these networks result in the co-construction of new knowledge?
For our very first walkthrough, we are going to focus exclusively on RQ1 from the original study and our question of interest about our educator network is:
To what extent, did educators engage with other participants in the discussion forums?
👉 Your Turn ⤵
Based on what you know about networks and the context so far, what other research questions might ask we ask in this context that a social network perspective might be able to answer?
In the space below, type a brief response to the following questions:
-
We’ll revisit your response towards the end and provide an opportunity to refine your research question after you know the data a little better.
1c. Load Libraries
As highlighted in Chapter 6 of Data Science in Education Using R (DSIEUR):
Packages are shareable collections of R code that can contain functions, data, and/or documentation. Packages increase the functionality of R by providing access to additional functions to suit a variety of needs.
Let’s check to see which packages have already been loaded into our RStudio Cloud workspace. Take a look at the the Files, Plots, & Packages Pane in the lower right hand corner of RStudio Cloud to make sure these packages have been installed and loaded:

You should see some familiar tidytext packages from our Getting Started Walkthrough like {dplyr} and {readr} which we’ll be using again shortly. You should also see an important package call {igraph} that will rely on heavily for our network analyses.
If you are working in RStudio Desktop, or notice that the packages have not been installed and/or loaded, run the following install.packages() function code to install the {tidyverse} and {igraph} packages:
install.packages("tidyverse")
install.packages("igraph")
Let’s go ahead and use library() function for the {tidyverse} package just to review the other packages from the tidyverse collection of packages that this package contains:
library(tidyverse)
Registered S3 methods overwritten by 'dbplyr':
method from
print.tbl_lazy
print.tbl_sql
── Attaching packages ────────────────────────────────────────────────────────────── tidyverse 1.3.1 ──
✓ ggplot2 3.3.3 ✓ purrr 0.3.4
✓ tibble 3.1.2 ✓ dplyr 1.0.6
✓ tidyr 1.1.3 ✓ stringr 1.4.0
✓ readr 1.4.0 ✓ forcats 0.5.1
── Conflicts ───────────────────────────────────────────────────────────────── tidyverse_conflicts() ──
x dplyr::filter() masks stats::filter()
x dplyr::lag() masks stats::lag()
🎉 igraph Package 📦

For our Unit 1 Walkthrough, we will rely heavily on the igraph network analysis package. The main goals of the igraph package and the collection of network analysis tools it contains are to provide a set of data types and functions for:
pain-free implementation of graph algorithms,
fast handling of large graphs, with millions of vertices and edges.
allowing rapid prototyping via high level languages like R.
Run the code chunk below to load the {igraph] library:
library(igraph)
Attaching package: ‘igraph’
The following objects are masked from ‘package:dplyr’:
as_data_frame, groups, union
The following objects are masked from ‘package:purrr’:
compose, simplify
The following object is masked from ‘package:tidyr’:
crossing
The following object is masked from ‘package:tibble’:
as_data_frame
The following objects are masked from ‘package:stats’:
decompose, spectrum
The following object is masked from ‘package:base’:
union
👉 Your Turn ⤵
Take a look at the messages from the output of after loading the igraph library. What tidyverse packages share identically named functions with igraph?
Write your response in the space below.
-
🧶 Knit & Check ✅
Congrats! You made it to the end of data wrangling section and are ready to start analysis! Before proceeding further, knit your document and check to see if you encounter any errors.
2. WRANGLE
In general, data wrangling involves some combination of cleaning, reshaping, transforming, and merging data (Wickham & Grolemund, 2017). The importance of data wrangling is difficult to overstate, as it involves the initial steps of going from the raw data to a dataset that can be explored and modeled (Krumm et al, 2018).
For our data wrangling this week, we’re keeping it simple since working with network data is a bit of a departure from our working with rectangular data frames. Our primary goals for Unit 1 are learning how to:
Import Data. Before working with data, we need to “read” it into R and once imported, we’ll take at different ways to view our data in R.
Create a Network Object.
Simplify Network. Finally, we’ll learn about a handy simplify() function in the {igraph} package for removing ties that .
2a. Import Data
The Edge-List Format
To get started, we need to import, or “read”, our data into R. The function used to import your data will depend on the file format of the data you are trying to import, but R is pretty adept at working with many files types.
Take a look in the /data folder in your Files pane. You should see the following .csv files:
dlt1-edgelist.csv
dlt1-nodes.csv
As its name implies, the first file dlt1-edgelist.csv is an edge-list that contains information about each tie, or relation between two actors in a network. In this context, a “tie” is a reply by one participant in the discussion forum to the post of another participant - or in some cases to their own post! These ties between a single actor are called “self-loops” and as we’ll see later in this section, igraph has a special function to remove these self loops from a sociogram, or network visualization.
The edge-list format is slightly different than other formats you have likely worked with before in that the values in the first two columns each row represent a dyad, or tie between two nodes in a network. An edge-list can also contain other information regarding the strength, duration, or frequency of the relationship, sometime called “weight”, in addition to other “edge attributes.”
In addition to
Sender = Unique identifier of author of comment
Receiver = Unique identifier of identified recipient of comment
Timestamp = Time comment was posted
Parent = Primary category or topic of thread
Category = Subcategory or subtopic of thread
Thread_id = Unique identifier of a thread
Comment_id = Unique identifier of a comment\
Let’s use the read_csv() function from the {readr} package introduced in the Getting Started walkthrough to read in our edge-list and print the new ties data frame:
ties <- read_csv("data/dlt1-edgelist.csv",
col_types = cols(Sender = col_character(),
Receiver = col_character(),
`Category Text` = col_skip(),
`Comment ID` = col_character(),
`Discussion ID` = col_character()))
ties
Note the addition of the col_types = argument for changing the column types to character strings since the numbers for for those particular columns indicate actors (Sender and Reciever) and attributes (Comment_ID and Discussion_Id). We also skipped the Category Text.
RStudio Tip: Importing data and dealing with data types can be a bit tricky, especially for beginners. Fortunately, RStudio has an “Import Dataset” feature in the Environment Pane that can help you use the {readr} package and associated functions to greatly facilitate this process.

👉 Your Turn ⤵
Consider the example pictured below of a discussion thread from the Planning for the Digital Learning Transition in K-12 Schools (DLT 1) where our data orginated. This thread was initiated by participant I, so the comments by J and N are considered to be directed at I. The comment of B, however, is a direct response to the comment by N as signaled by the use of the quote-feature as well as the explicit mentioning of N’s name within B’s comment.

Now answer the following questions as they relate to the DLT 1 edge-list we just read into R.
Which actors in this thread are the Sender and the Reciever? Which actor is both?
How many dyads are in this thread? Which pairs of actors are dyads?
Sidebar: Unfortunately, these types of nuances in discussion forum data as illustrated by this simple example are rarely captured through automated approaches to constructing networks. Fortunately, the dataset you are working with was carefully reviewed to try and capture more accurately the intended recipients of each reply.
Node Attributes
The second file is we’ll be using to help understand out network and the actors involved contains all the nodes or actors (i.e., participants who posted to the discussion forum) as well as some of their attributes such as gender and years of experience in education.
Carolyn (2013) notes that most social network analyses include variables that describe attributes of actors, ones that are either categorical (e.g., sex, race, etc.) or continuous in nature (e.g., test scores, number of times absent, etc.). These attributes that can be incorporated into a network graph or model to making it much more informative and can aid in testing or generating hypotheses.
These attribute variables are typically included in a rectangular array, or dataframe, that mimics the actor-by-attribute that is the dominant convention in social science, i.e. rows represent cases, columns represent variables, and cells consist of values on those variables.
As and aside, Carolyn also refers to this historical preference by researchers for “actor-by-attribute” data, in the absence of relational data in which the actor has been removed their social context, as the “sociological meatgrinder” in action. Specifically, this historical approach assumes that the actor does not interact with anyone else in the study and that outcomes are solely dependent of the characteristics of the individual.
Regardless, let’s read in our node attribute file and take a look at the actors and their attributes included in our dataset:
actors <- read_csv("data/dlt1-nodes.csv",
col_types = cols(UID = col_character(),
Facilitator = col_character(),
expert = col_character(),
connect = col_character()))
👉 Your Turn ⤵
Use the code chunk below and a function of your choosing to take a look at the actors data frame:
Match up the attributes included in the node file with the following codebook descriptors. The first one has been done as an example.
Facilitator = Identification of course facilitator (1 = instructor)
- Dummy variable for whether participants listed networking/collaboration with others as one of their course goals on the registration form
- Identifier of “expert panelists” invited to course to share experience through recorded Q&A
- Identification of course facilitator (1 = instructor)
- Professional role (eg, teacher, librarian, administrator)
- Years of experience as an educator
- Works with elementary, middle, and/or high school students
- Initial assignment of discussion group
2b. Create Network Object
Before we can begin using many of the functions from the {igraph} for summarizing and visualizing our DLT 1 network, we first need to convert the data frames that we imported into an igraph network object, or an igraph graph.
Convert to igraph Graph
To do that, we will use the graph_from_data_frame() function. Note that I included the eval=FALSE argument in the code block below to prevent this code from running when we knit our final document. Otherwise it will produce an error since we can’t include help documentation in our knitted HTML file.
Run the following code to take a look at the help documentation for this function:
?graph_from_data_frame
You probably saw that this particular function takes the following three arguments, two of which are data frames:
d describes the edges of the network. The first two columns are the IDs of the source and the target node for each edge, in our case the Sender and Reviever of a discussion post. The order matters! The following columns are edge attributes such as weight, type, label, or anything else.
vertices starts with a column of node IDs and any following columns are interpreted as node attributes.
directed is determines whether or not to create a directed graph.
Run the following code to specify our ties data frame as the edges of our network, our actors data frame for the vertices of our network and their attributes, and indicate that this is indeed a directed network.
network <- graph_from_data_frame(d = ties,
vertices = actors,
directed = T)
network
IGRAPH b92ec87 DN-- 445 2529 --
+ attr: name (v/c), Facilitator (v/c), role1 (v/c), experience (v/n), experience2
| (v/c), grades (v/c), location (v/c), region (v/c), country (v/c), group (v/c),
| gender (v/c), expert (v/c), connect (v/c), Timestamp (e/c), Discussion Title (e/c),
| Discussion Category (e/c), Parent Category (e/c), Discussion Identifier (e/c),
| Comment ID (e/c), Discussion ID (e/c)
+ edges from b92ec87 (vertex names):
[1] 360->444 356->444 356->444 344->444 392->444 219->444 318->444 4 ->444 355->356 355->444
[11] 4 ->444 310->444 248->444 150->444 19 ->310 216->19 19 ->444 19 ->4 217->310 385->444
[21] 217->444 393->444 217->19 256->219 253->444 301->444 301->444 143->444 218->19 361->217
[31] 30 ->444 30 ->444 335->444 166->444 156->219 173->444 223->444 219->19 219->253 261->444
+ ... omitted several edges
Carolyn (2013) reminds us that one of the simplest and often ignored structural property of a social network is its size and explains that:
size is simply a measure of the number of nodes in the network.
He notes that the size of a network plays an important role in determining what happens in the network. For example, in a classroom of 30 students, it is not hard to imagine that the pattern of who communicates with whom will look much different than if the network consisted of hundreds or even thousands of students like in a MOOC.
👉 Your Turn ⤵
Take a look at the very first line of the output which contains some basic information about our network and answer the following questions:
How many notes and edges are in our network? Is this consistent with the number of observations in our data frames? Hint: Check the Environment pane.
The “D” and the “N” indicate that this is a Directed network and has the Name vertex attributes set. Why do the two spaces that follow these letters have dashes? Hint: check the help files.
Which vertex attribute did igraph interpret as numeric?
Simplify Graph
As you saw from the network output, our dataset has 2529 edges or ties and just a quick scan of the edges in the network shows that edges like 356 -> 444 occur at least more than once. So we know that participant 356 has replied to participant 444 at least twice.
Fortunately, the {igraph} package has a simplify() function for collapsing these duplicate edges so they are not represented more than once when we want visually depict our network with a sociogram.
Let’s use that function to simplify our network and save it as a simple_network, or a simple graph, which contains no self-loops or duplicate edges and which by default the simplify() function removes:
simple_network <- simplify(network)
simple_network
👉 Your Turn ⤵
Take a look at the output for our simple graph now and answer the following questions:
How many unique edges are in the network?
Did we lose any important or potentially useful information by collapsing multiple edges into a single edge?
Add Edge Weights
We noted earlier that edges can also contain attributes such as strength, duration or frequency, sometime called “weight.” These weights can not only help us better understand the relationship between two actors, but also aid in visualization and modeling later on.
When we used the simplify() function earlier, it collapsed our duplicate edges but we lost some vital information as a result, namely the frequency of replies among pairs of educators in our discussion forum.
Fortunately, the simplify() function contains an argument that will allow us to count the number of ties between two actors, similar to how we might use the count() function in the {dplyr} package like so:
edge_weights <- count(ties, Sender, Receiver)
edge_weights
In this case, we see that participant 1 replied to participant 144 twice throughout the course.
To add weights to our simplified network, we first need to add a weight variable to the edges in our original network igraph object.
The {igraph} package has a unique syntax for working with attributes of network objects. To add a weight attribute to the E() edges in our network we’ll use the $ operator which can be used to create a new weight variable – or select a variable as we’ll see later on – and use the <- assignment operator to add an initial value of 1 for the weight of each edge.
Let’s put that all together and run the code to add a weight of 1 to each edge in our network
E(network)$weight <- 1
Now let’s take a look at our igraph network object again:
network
We can see that our network is now weighted as indicated by the “W” and that our new weight attribute has been added.
weighted_network <- simplify(network,
edge.attr.comb = list(weight="sum")
)
weighted_network
👉 Your Turn ⤵
🧶 Knit & Check ✅
Congrats! You made it to the end of data wrangling section and are ready to start analysis! Before proceeding further, knit your document and check to see if you encounter any errors.
3. EXPLORE
As highlighted in both DSEIUR and Learning Analytics Goes to School, calculating summary statistics, data visualization, and feature engineering (the process of creating new variables from a dataset) are a key part of exploratory data analysis. One goal in this phase is explore questions that drove the original analysis and develop new questions and hypotheses to test in later stages.
In Section 3, we will learn some new functions for retrieving basic network descriptives related to our research question and create a network visualization to help illustrate key findings. Specifically, this section we’ll learn to:
Examine Basic Descriptives. We focus primarily on actors and edges in this walkthrough, including the edges wights we added in the previous section as well as node degree, and import and fairly intuitive measure of centrality.
Make a Sociogram. Finally, we wrap up the explore phases by learning to plot a network and tweak key elements like the size, shape, and position of nodes and edges to better at communicating key findings.
3a. Examine Basic Descriptives
Edge Weights
mean(edge_weights$n)
median(edge_weights$n)
hist(edge_weights$n, breaks = 10)
Now that we’ve looked at the typical frequency of those
Node Degree
A key structural property of networks is the concept of centralization. A network that is highly centralized is one in which relations are focused on a small number of actors or even a single actor in a network, whereas ties in a decentralized network are diffuse and spread over a number of actors. One of the most common measure of centralization is degree
Degree is the number of ties to and from an ego. In a directed network, in-degree is the number of ties received, whereas out-degree is the number of ties sent.
The {igraph} package has an aptly named function degree() for retrieving degree, in-degree, and out-degree for all actors in a network.
Run the following code to extract measures and save to node_degree which we’ll examine in just a bit:
node_degree <- degree(weighted_network, mode="all")
Note that we set the mode = argument in this function to “all” which give us the total number of participants that each actor in our network with sent or received a reply.
Let’s take a look at the distribution of node_degree in our network by using R’s built in hist() function for creating histograms. I set the value of breaks =, or bins in our histogram, to 30 since I already know some actors in this network have a very high degree.
hist(node_degree, breaks = 30)

We can see that most actors in the network are connected to very few individuals while a couple actors in this network are connected to a very larger number of alters.
Now let’s take a look at the mean and median for node_degree using some other {base} R functions:
mean(node_degree)
[1] 8.701124
median(node_degree)
[1] 4
We see that the mean suggests the participants are, on average, connected to about 8 other participants in the MOOC-Ed, but this is likely heavily skewed by the two individuals with a disproportionate number of connections. The median is probably a better characterization of the typical number of educators a participant has sent or received a reply.
In-Degree
Let’s go ahead and take a look at in-degree next:
in_degree <- degree(weighted_network, mode="in")
hist(in_degree, breaks = 30)

mean(in_degree)
[1] 4.350562
median(in_degree)
[1] 1
👉 Your Turn ⤵
Use the code chunk
In the space below, write your interpretation of these results.
-
3b. Make a Sociogram
igraph arguments only
plot(weighted_network)
Hair ball
Remove Labels
plot(weighted_network,
vertex.label = NA)
Change vertex size
plot(weighted_network,
vertex.label = NA,
vertex.size = 1)
degree
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree)
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree*.1)
Reduce arrow size
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree*.1,
edge.arrow.size = .04)
Adjust Edge Width
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree*.05,
edge.arrow.size = .04,
edge.width = .2)
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree*.1,
edge.arrow.size = .04,
edge.width = E(weighted_network)$weight)
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree*.05,
edge.arrow.size = .05,
edge.width = E(weighted_network)$weight/5)
Change Layout
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree*.05,
edge.arrow.size = .05,
edge.width = E(weighted_network)$weight/5,
layout = layout_with_fr)
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree*.05,
edge.arrow.size = .05,
edge.width = E(weighted_network)$weight/5,
layout = layout_with_kk)
plot(weighted_network,
vertex.label = NA,
vertex.size = node_degree*.05,
edge.arrow.size = .05,
edge.width = E(weighted_network)$weight/5,
layout = layout_in_circle)
👉 Your Turn ⤵
We’ve only scratched the surface of what’s possible with network plotting but hopefully this have given you a sense of
🧶 Knit & Check ✅
Congrats! You made it to the end of the Explore section and are ready to learn a little about network modeling! Before proceeding further, knit your document and check to see if you encounter any errors.
4. MODEL
As highlighted in Chapter 3 of Data Science in Education Using R, the Model step of the data science process entails “using statistical models, from simple to complex, to understand trends and patterns in the data.” The authors note that while descriptive statistics and data visualization during the Explore step can help us to identify patterns and relationships in our data, statistical models can be used to help us determine if relationships, patterns and trends are actually meaningful.
We will not explore the use of models for SNA until Unit 3, recall from the PREPARE section that the Kellogg et al. study was guided by the following questions:
What are the patterns of peer interaction and the structure of peer networks that emerge over the course of a MOOC-Ed?
To what extent do participant and network attributes (e.g., homophily, reciprocity, transitivity) account for the structure of these networks?
To what extent do these networks result in the co-construction of new knowledge?
To address Question 1, actors in the network were categorized into distinct mutually exclusive groups using the core-periphery and regular equivalence functions of UCINET. The former used the CORR algorithm to divide the network into actors that are part of a densely connected subgroup, or “core”, from those that are part of the sparsely connected periphery. Regular equivalence employs the REGE blockmodeling algorithm to partition, or group, actors in the network based on the similarity of their ties to others with similar ties. In essence, blockmodeling provides a systematic way for categorizing educators based on the ways in which they interacted with peers.
As we saw upon just a basic visual inspection of our network during the Explore section, there was a small core of highly connected participants surrounded by those on the “periphery,” or edge, of the network with very few connections. In the DLT 2 course, those on the periphery made up roughly 90% of network. The study also found relatively high levels of reciprocation, but also found that roughly a quarter of participants were characterized as “brodcasters” – educators who initiated a discussion thread, but neither reciprocated with those who replied, nor posted to threads initiated by others.
To address Question 2, this study use the exponential family of random graph models (ERGM; also known as p* models), which provide a statistical approach to network modeling that addresses the complex dependencies within networks. ERGMs predict network ties and determine the statistical likelihood of a given network structure, based on an assumed dependency structure, the attributes of the individuals (e.g., gender, popularity, location, previous ties) and prior states of the network.
5. COMMUNICATE
The final step in our workflow/process is sharing the results of analysis with wider audience. Krumm et al. (2018) have outline the following 3-step process for communicating with education stakeholders what you have learned through analysis:
Select. Communicating what one has learned involves selecting among those analyses that are most important and most useful to an intended audience, as well as selecting a form for displaying that information, such as a graph or table in static or interactive form, i.e. a “data product.”
Polish. After creating initial versions of data products, research teams often spend time refining or polishing them, by adding or editing titles, labels, and notations and by working with colors and shapes to highlight key points.
Narrate. Writing a narrative to accompany the data products involves, at a minimum, pairing a data product with its related research question, describing how best to interpret the data product, and explaining the ways in which the data product helps answer the research question.
Next week we’ll take a look at refining our analysis and ways we might communicate and share findings with education stakeholders.
👉 Your Turn ⤵
Now that you’ve become more familiar with this dataset and the social network perspective, what other aspects of this dataset, or a dataset you are interested in exploring, could you investigate?
-
What specific research questions might you ask that would be helpful for being understanding and improving learning, or the context in which the data is collected?
-
🧶 Knit & Check ✅
Congrats! You’ve finished the Unit 1 Guided Walkthrough and are ready for some independent analysis next week!
To complete this assignment, knit your document and send me an email at sbkellog@ncsu.edu letting me know you’re all set.
LS0tCnRpdGxlOiAnVW5pdCAxIFdhbGt0aHJvdWdoOiBQZWVyIEludGVyYWN0aW9uICYgTU9PQy1FZHMnCnN1YnRpdGxlOiAiRUNJIDU4OSBTb2NpYWwgTmV0d29yayBBbmFseXNpcyBhbmQgRWR1Y2F0aW9uIgphdXRob3I6ICJEci4gU2hhdW4gS2VsbG9nZyIKZGF0ZTogImByIGZvcm1hdChTeXMuRGF0ZSgpLCclQiAlZSwgJVknKWAiCm91dHB1dDoKICBodG1sX2RvY3VtZW50OgogICAgdG9jOiB5ZXMKICAgIHRvY19kZXB0aDogNAogICAgdG9jX2Zsb2F0OiB5ZXMKICAgIGRmX3ByaW50OiBwYWdlZAogIGh0bWxfbm90ZWJvb2s6CiAgICB0b2M6IHllcwogICAgdG9jX2Zsb2F0OiB5ZXMKICAgIHRoZW1lOiBkZWZhdWx0CiAgICB0b2NfZGVwdGg6IDQKZWRpdG9yX29wdGlvbnM6CiAgbWFya2Rvd246CiAgICB3cmFwOiA3MgotLS0KCmBgYHtyIHNldHVwLCBpbmNsdWRlPUZBTFNFfQprbml0cjo6b3B0c19jaHVuayRzZXQoZWNobyA9IFRSVUUpCmBgYAoKIyAxLiBQUkVQQVJFCgpEdXJpbmcgdGhlIHNlY29uZCB3ZWVrIG9mIGVhY2ggdW5pdCwgd2UnbGwgKioid2FsayB0aHJvdWdoIioqIGEgYmFzaWMKcmVzZWFyY2ggd29ya2Zsb3csIG9yIGRhdGEgYW5hbHlzaXMgcHJvY2VzcywgbW9kZWxlZCBhZnRlciB0aGUKRGF0YS1JbnRlbnNpdmUgUmVzZWFyY2ggV29ya2Zsb3cgZnJvbSBbTGVhcm5pbmcgQW5hbHl0aWNzIEdvZXMgdG8KU2Nob29sXShodHRwczovL2NhdGFsb2cubGliLm5jc3UuZWR1L2NhdGFsb2cvTkNTVTQ4NjIxMzQpIChLcnVtbSBldCBhbC4sCjIwMTgpOgoKIVtdKGltZy93b3JrZmxvdy5wbmcpe3dpZHRoPSI4MCUifQoKRWFjaCB3YWxrdGhyb3VnaCB3aWxsIGZvY3VzIG9uIGEgYmFzaWMgYW5hbHlzaXMgZ3VpZGVkIGJ5IHRoZSBzb2NpYWwKbmV0d29yayBwZXJzcGVjdGl2ZS4gVGhpcyB3ZWVrLCBvdXIgZm9jdXMgd2lsbCBiZSBvbiBwcmVwYXJpbmcKcmVsYXRpb25hbCBkYXRhIGZvciBhbmFseXNpcywgcHV0dGluZyB0b2dldGhlciBzb21lIGJhc2ljIG5ldHdvcmsKZGVzY3JpcHRpdmVzLCBhbmQgcGxvdHRpbmcgYSBuZXR3b3JrIHZpc3VhbGl6YXRpb24gdG8gaGVscCBpbGx1c3RyYXRlCmtleSBmaW5kaW5ncy4KClNwZWNpZmljYWxseSwgdGhlIFVuaXQgMSBXYWxrdGhyb3VnaCB3aWxsIGNvdmVyIHRoZSBmb2xsb3dpbmcgdG9waWNzOgoKMS4gICoqUHJlcGFyZSoqOiBQcmlvciB0byBhbmFseXNpcywgd2UnbGwgdGFrZSBhIGxvb2sgYXQgdGhlIGNvbnRleHQKICAgIGZyb20gd2hpY2ggb3VyIGRhdGEgY2FtZSwgZm9ybXVsYXRlIHNvbWUgcmVzZWFyY2ggcXVlc3Rpb25zLCBhbmQgZ2V0CiAgICBpbnRyb2R1Y2VkIHRoZSB7aWdyYXBofSBSIHBhY2thZ2UgZm9yIG5ldHdvcmsgYW5hbHlzaXMuCgoyLiAgKipXcmFuZ2xlKio6IFdyYW5nbGluZyBkYXRhIGVudGFpbHMgdGhlIHdvcmsgb2YgbWFuaXB1bGF0aW5nLAogICAgY2xlYW5pbmcsIHRyYW5zZm9ybWluZywgYW5kIG1lcmdpbmcgZGF0YS4gSW4gc2VjdGlvbiAyIHdlIGZvY3VzIG9uCiAgICBpbXBvcnRpbmcgbmV0d29yayBkYXRhLCBjb252ZXJ0aW5nIG91ciBmYW1pbGlhciBkYXRhIGZyYW1lcyBpbnRvIGEKICAgIG5ldHdvcmsgb2JqZWN0IHRoYXQgY2FuIGJlIGFuYWx5emVkIGFuZCBncmFwaGVkLCBhbmQgbGVhcm4gYWJvdXQKICAgICJzaW1wbGUgZ3JhcGhzLiIKCjMuICAqKkV4cGxvcmUqKjogSW4gc2VjdGlvbiAzLCB3ZSBjYWxjdWxhdGUgc29tZSBiYXNpYyBuZXR3b3JrCiAgICBkZXNjcmlwdGl2ZXMgYW5kIGxlYXJuIGhvdyB0byBzdW1tYXJpemUgdGhlIHN0YXRzIHdpdGggYSBzb2Npb2dyYW0uCgo0LiAgKipNb2RlbCoqOiBXaGlsZSB3ZSB3b24ndCBkaWcgaW50byBhcHByb2FjaGVzIGZvciBtb2RlbGluZyBuZXR3b3JrCiAgICBkYXRhIFVuaXQgMywgd2Ugd2lsbCB0YWtlIGEgcXVpY2sgbG9vayBhdCBzb21lIGFwcHJvYWNoZXMgdXNlZCBpbgogICAgdGhlIHN0dWR5IGd1aWRpbmcgdGhpcyB3YWxrdGhyb3VnaC4KCjUuICAqKkNvbW11bmljYXRlKio6IFdlJ2xsIGxlYXJuIG1vcmUgYWJvdXQgY29tbXVuaWNhdGluZyBrZXkgZmluZGluZ3MKICAgIG5leHQgd2VlaywgYnV0IGZvciBub3cgd2lsbCBiZSBpbnRyb2R1Y2VkIHRvIHRoZSBiYXNpYyBjb21wb25lbnRzIG9mCiAgICBhIGRhdGEgcHJvZHVjdC4KCiMjIDFhLiBSZXZpZXcgdGhlIFJlc2VhcmNoCgpQcmlvciB0byBhbmFseXNpcywgaXQncyBjcml0aWNhbCB0byB1bmRlcnN0YW5kIHRoZSBjb250ZXh0IGFuZCBkYXRhCnNvdXJjZXMgYXZhaWxhYmxlIHNvIHlvdSBjYW4gZm9ybXVsYXRlIHVzZWZ1bCBxdWVzdGlvbnMgdGhhdCBjYW4gYmUKZmVhc2libHkgYWRkcmVzc2VkIGJ5IHlvdXIgZGF0YS4gSW4gW1NvY2lhbCBOZXR3b3JrIEFuYWx5c2lzIGFuZApFZHVjYXRpb246IFRoZW9yeSwgTWV0aG9kcyAmCkFwcGxpY2F0aW9uc10oaHR0cHM6Ly9tZXRob2RzLnNhZ2VwdWIuY29tL2Jvb2svc29jaWFsLW5ldHdvcmstYW5hbHlzaXMtYW5kLWVkdWNhdGlvbiksCkNhcm9seW4gKDIwMTMpIG5vdGVzIHRoYXQ6Cgo+IHRoZSAqKnNvY2lhbCBuZXR3b3JrIHBlcnNwZWN0aXZlKiogaXMgb25lIGNvbmNlcm5lZCB3aXRoIHRoZSBzdHJ1Y3R1cmUKPiBvZiByZWxhdGlvbnMgYW5kIHRoZSBpbXBsaWNhdGlvbiB0aGlzIHN0cnVjdHVyZSBoYXMgb24gaW5kaXZpZHVhbCBvcgo+IGdyb3VwIGJlaGF2aW9yIGFuZCBhdHRpdHVkZXMKCk1vcmUgc3BlY2lmaWNhbGx5LCBDYXJvbHluIGNpdGVzIHRoZSBmb2xsb3dpbmcgZm91ciBmZWF0dXJlcyB1c2VkIGJ5CkZyZWVtYW4gKDIwMDQpIHRvIGRlZmluZSB0aGUgc29jaWFsIG5ldHdvcmsgcGVyc3BlY3RpdmU6CgoxLiAgU29jaWFsIG5ldHdvcmsgYW5hbHlzaXMgaXMgKiptb3RpdmF0ZWQgYnkgYSByZWxhdGlvbmFsIGludHVpdGlvbioqCiAgICBiYXNlZCBvbiB0aWVzIGNvbm5lY3Rpbmcgc29jaWFsIGFjdG9ycy4KCjIuICBJdCBpcyBmaXJtbHkgKipncm91bmRlZCBpbiBzeXN0ZW1hdGljIGVtcGlyaWNhbCBkYXRhKiouCgozLiAgSXQgKiptYWtlcyoqICoqdXNlIG9mIGdyYXBoaWMgaW1hZ2VyeSoqIHRvIHJlcHJlc2VudCBhY3RvcnMgYW5kCiAgICB0aGVpciByZWxhdGlvbnMgd2l0aCBvbmUgYW5vdGhlci4KCjQuICBJdCAqKnJlbGllcyoqICoqb24qKiAqKm1hdGhlbWF0aWNhbCBhbmQvb3IgY29tcHV0YXRpb25hbCBtb2RlbHMqKiB0bwogICAgc3VjY2luY3RseSByZXByZXNlbnQgdGhlIGNvbXBsZXhpdHkgb2Ygc29jaWFsIGxpZmUuCgpGb3IgVW5pdCAxLCBvdXIgd2Fsa3Rocm91Z2ggd2lsbCBiZSBndWlkZWQgYnkgcHJldmlvdXMgcmVzZWFyY2ggYW5kCmV2YWx1YXRpb24gd29yayBjb25kdWN0ZWQgYnkgdGhlIEZyaWRheSBJbnN0aXR1dGUgZm9yIEVkdWNhdGlvbmFsCklubm92YXRpb24gYXMgcGFydCBvZiB0aGUgTWFzc2l2ZWx5IE9wZW4gT25saW5lIENvdXJzZXMgZm9yIEVkdWNhdG9ycwooTU9PQy1FZCkgaW5pdGlhdGl2ZS4KCiMjIyBBIFNvY2lhbCBOZXR3b3JrIFBlcnNwZWN0aXZlIGluIE1PT0MtRWRzCgohW10oaW1nL2lycm9kbC1hcnRpY2xlLnBuZyl7d2lkdGg9IjQwJSJ9CgpLZWxsb2dnLCBTLiwgQm9vdGgsIFMuLCAmIE9saXZlciwgSy4gKDIwMTQpLiBbQSBzb2NpYWwgbmV0d29yawpwZXJzcGVjdGl2ZSBvbiBwZWVyIHN1cHBvcnRlZCBsZWFybmluZyBpbiBNT09DcyBmb3IKZWR1Y2F0b3JzXShodHRwczovL2dpdGh1Yi5jb20vc2JrZWxsb2dnL2VjaS01ODkvYmxvYi9tYWluL3VuaXQtMS9saXQvc25hX21vb2NfaXJyb2RsX2JqZXRfYXJ0aWNsZXMucGRmKS7CoCpJbnRlcm5hdGlvbmFsClJldmlldyBvZiBSZXNlYXJjaCBpbiBPcGVuIGFuZCBEaXN0cmlidXRlZCBMZWFybmluZyoswqAqMTUqKDUpLCAyNjMtMjg5LgoKIyMjIyBSZXNlYXJjaCBDb250ZXh0CgpJbiB0aGUgc3ByaW5nIG9mIDIwMTMsIFRoZSBGcmlkYXkgSW5zdGl0dXRlIGxhdW5jaGVkIHRoZSBNT09DLUVkCkluaXRpYXRpdmUgdG8gZXhwbG9yZSB0aGUgcG90ZW50aWFsIG9mIGRlbGl2ZXJpbmcgcGVyc29uYWxpemVkLApoaWdoLXF1YWxpdHkgcHJvZmVzc2lvbmFsIGRldmVsb3BtZW50IHRvIGVkdWNhdG9ycyBhdCBzY2FsZSAoS2xlaW1hbiBldAphbC4sIDIwMTMpLiBJbiBjb2xsYWJvcmF0aW9uIHdpdGggdGhlIEFsbGlhbmNlIGZvciBFeGNlbGxlbnQgRWR1Y2F0aW9uLAp0aGUgRnJpZGF5IEluc3RpdHV0ZSBsYXVuY2hlZCB0aGlzIGluaXRpYXRpdmUgd2l0aCBhIDYtd2VlayBwaWxvdCBjb3Vyc2UKY2FsbGVkIFBsYW5uaW5nIGZvciB0aGUgRGlnaXRhbCBMZWFybmluZyBUcmFuc2l0aW9uIGluIEstMTIgU2Nob29scyAoRExUCjEpLCB3aGljaCB3YXMgb2ZmZXJlZCBhZ2FpbiBpbiBTZXB0ZW1iZXIgMjAxMyAoRExUIDIpLiBUaGlzIGNvdXJzZSB3YXMKZGVzaWduZWQgdG8gaGVscCBzY2hvb2wgYW5kIGRpc3RyaWN0IGxlYWRlcnMgcGxhbiBhbmQgaW1wbGVtZW50IEstMTIKZGlnaXRhbCBsZWFybmluZyBpbml0aWF0aXZlcy4KCkFjYWRlbWljcywgYXMgd2VsbCBhcyBwdW5kaXRzIGZyb20gdHJhZGl0aW9uYWwgYW5kIG5ldyBtZWRpYSwgaGF2ZQpyYWlzZWQgYSBudW1iZXIgb2YgY29uY2VybnMgYWJvdXQgTU9PQ3MsIGluY2x1ZGluZyB0aGUgbGFjayBvZgppbnN0cnVjdGlvbmFsIGFuZCBzb2NpYWwgc3VwcG9ydHMuIEFtb25nIHRoZSBjb3JlIGRlc2lnbiBwcmluY2lwbGVzIG9mCk1PT0MtRWRzIGFyZSBjb2xsYWJvcmF0aW9uIGFuZCBwZWVyLXN1cHBvcnRlZCBsZWFybmluZy4gSXQgaXMgYW4KYXNzdW1wdGlvbiBvZiB0aGlzIHN0dWR5IHRoYXQgY2hhbGxlbmdlcyBhcmlzaW5nIGZvcm0gdGhpcyBwcm9ibGVtIG9mCnNjYWxlIGNhbiBiZSBhZGRyZXNzZWQgYnkgbGV2ZXJhZ2luZyB0aGVzZSBtYXNzaXZlIG51bWJlcnMgdG8gZGV2ZWxvcApyb2J1c3Qgb25saW5lIGxlYXJuaW5nIGNvbW11bml0aWVzLgoKVGhpcyBtaXhlZC1tZXRob2RzIGNhc2Ugc3R1ZHkgdXNlZCBib3RoIFNOQSBhbmQgcXVhbGl0YXRpdmUgbWV0aG9kcyB0bwpiZXR0ZXIgdW5kZXJzdGFuZCBwZWVyIHN1cHBvcnQgaW4gTU9PQy1FZHMgdGhyb3VnaCBhbiBleGFtaW5hdGlvbiBvZiB0aGUKY2hhcmFjdGVyaXN0aWNzLCBtZWNoYW5pc21zLCBhbmQgb3V0Y29tZXMgb2YgcGVlciBuZXR3b3Jrcy4gRmluZGluZ3MKZnJvbSB0aGlzIHN0dWR5IGRlbW9uc3RyYXRlIHRoYXQgZXZlbiB3aXRoIHRlY2hub2xvZ3kgYXMgYmFzaWMgYXMgYQpkaXNjdXNzaW9uIGZvcnVtLCBNT09DcyBjYW4gYmUgbGV2ZXJhZ2VkIHRvIGZvc3RlciB0aGVzZSBuZXR3b3JrcyBhbmQKZmFjaWxpdGF0ZSBwZWVyLXN1cHBvcnRlZCBsZWFybmluZy4gQWx0aG91Z2ggdGhpcyBzdHVkeSB3YXMgbGltaXRlZCB0bwp0d28gdW5pcXVlIGNhc2VzIGFsb25nIHRoZSB3aWRlIHNwZWN0cnVtIG9mIE1PT0NzLCB0aGUgbWV0aG9kcyBhcHBsaWVkCnByb3ZpZGUgb3RoZXIgcmVzZWFyY2hlcnMgd2l0aCBhbiBhcHByb2FjaCBmb3IgYmV0dGVyIHVuZGVyc3RhbmRpbmcgdGhlCmR5bmFtaWMgcHJvY2VzcyBvZiBwZWVyIHN1cHBvcnRlZCBsZWFybmluZyBpbiBNT09Dcy4KCiMjIyMgRGF0YSBTb3VyY2VzCgoqKk1PT0MtRWQgcmVnaXN0cmF0aW9uIGZvcm0uKiogQWxsIHBhcnRpY2lwYW50cyBjb21wbGV0ZWQgYSByZWdpc3RyYXRpb24KZm9ybSBmb3IgZWFjaCBNT09DLUVkIGNvdXJzZS4gVGhlIHJlZ2lzdHJhdGlvbiBmb3JtIGNvbnNpc3RzIG9mCnNlbGYtcmVwb3J0ZWQgZGVtb2dyYXBoaWMgZGF0YSwgaW5jbHVkaW5nIGluZm9ybWF0aW9uIHJlbGF0ZWQgdG8gdGhlaXIKcHJvZmVzc2lvbmFsIHJvbGUgYW5kIHdvcmsgc2V0dGluZywgeWVhcnMgb2YgZXhwZXJpZW5jZSBpbiBlZHVjYXRpb24sCmFuZCBwZXJzb25hbCBsZWFybmluZyBnb2Fscy4KCioqTU9PQy1FZCBkaXNjdXNzaW9uIGZvcnVtcy4qKiBBbGwgcGVlciBpbnRlcmFjdGlvbiwgaW5jbHVkaW5nIHBlZXIKZGlzY3Vzc2lvbiwgZmVlZGJhY2ssIGFuZCByZWFjdGlvbnMgKGUuZy4sIGxpa2VzKSwgdGFrZSBwbGFjZSB3aXRoaW4gdGhlCmZvcnVtIGFyZWEgb2YgTU9PQy1FZHMsIHdoaWNoIGFyZSBwb3dlcmVkIGJ5IFZhbmlsbGEgRm9ydW1zLiBCZWNhdXNlIG9mCnRoZSBzcGVjaWZpYyBmb2N1cyBvbiBwZWVyIHN1cHBvcnRlZCBsZWFybmluZywgcG9zdGluZ3MgdG8gb3IgZnJvbQpjb3Vyc2UgZmFjaWxpdGF0b3JzIGFuZCBzdGFmZiB3ZXJlIHJlbW92ZWQgZnJvbSB0aGUgZGF0YSBzZXQuIEZpbmFsbHksCmFuYWx5c2VzIGRlc2NyaWJlZCBiZWxvdyBleGNsdWRlIG1vcmUgcGFzc2l2ZSBmb3JtcyBvZiBpbnRlcmFjdGlvbnMKKGkuZS4sIHJlYWQgYW5kIHJlYWN0aW9uIGxvZ3MpLCBhbmQgaW5jbHVkZSBvbmx5IHBvc3RpbmdzIGFtb25nIHBlZXJzLgoKRm9yIG91ciBVbml0IDEgd2Fsa3Rocm91Z2gsIHdlJ2xsIHRha2UgYSBsb29rIGF0IGRhdGEgZnJvbSB0aGUgb3JpZ2luYWwKRGlnaXRhbCBMZWFybmluZyBUcmFuc2l0aW9uIGluIEstMTIgU2Nob29scyAoRExUIDEpIHRoYXQgd2FzIG5vdAppbmNsdWRlZCBpbiB0aGlzIHN0dWR5IHRvIGFsbG93IGZvciBjb21wYXJpc29ucyB0byB0aGUgZmluZGluZ3MgaW4gdGhpcwpzdHVkeS4gQWxzbywgZm9yIHlvdXIgaW5kZXBlbmRlbnQgYW5hbHlzaXMsIHlvdSBtYXkgd2FudCB0byBjb25zaWRlcgp3b3JraW5nIHdpdGggdGhlIERMVCAyIGRhdGEgdG8gc2VlIGlmIHlvdSBjYW4gcmVwbGljYXRlIHNvbWUgb2YgdGhlCmZpbmRpbmdzIGZyb20gdGhpcyBwYXBlciEKCiMjIyAqKvCfkYkgWW91ciBUdXJuKiogKiripLUqKgoKVGFrZSBhIHF1aWNrIGxvb2sgYXQgdGhlICpEZXNjcmlwdGlvbiBvZiB0aGUgRGF0YXNldCogc2VjdGlvbiBmcm9tIHRoZQpbTWFzc2l2ZWx5IE9wZW4gT25saW5lIENvdXJzZSBmb3IgRWR1Y2F0b3JzIChNT09DLUVkKSBuZXR3b3JrCmRhdGFzZXRdKGh0dHBzOi8vZ2l0aHViLmNvbS9zYmtlbGxvZ2cvZWNpLTU4OS9ibG9iL21haW4vdW5pdC0xL2xpdC9iamV0XzEyMzEyX1Jldi5wZGYpCkJKRVQgYXJ0aWNsZSBhbmQgdGhlIGFjY29tcGFueWluZyBkYXRhIHNldHMgc3RvcmVkIG9uIFtIYXJ2YXJkCkRhdGF2ZXJzZV0oaHR0cHM6Ly9kYXRhdmVyc2UuaGFydmFyZC5lZHUvZGF0YXNldC54aHRtbD9wZXJzaXN0ZW50SWQ9ZG9pOjEwLjc5MTAvRFZOL1paSDNVQikKdGhhdCB3ZSdsbCBiZSB1c2luZyBmb3IgdGhpcyB3YWxrdGhyb3VnaC4KCkluIHRoZSBzcGFjZSBiZWxvdywgdHlwZSBhIGJyaWVmIHJlc3BvbnNlIHRvIHRoZSBmb2xsb3dpbmcgcXVlc3Rpb25zOgoKMS4gIFdoYXQgd2VyZSBzb21lIG9mIHRoZSBzdGVwcyBuZWNlc3NhcnkgdG8gY29uc3RydWN0IHRoaXMgZGF0YXNldD8KCiAgICAtICAgCgoyLiAgV2hhdCB0d28gIm5vZGUgYXR0cmlidXRlcyIgZnJvbSB0aGUgZGF0YXNldCB0aGF0IG1pZ2h0IGJlIHVzZWZ1bCBmb3IKICAgIHByZWRpY3RpbmcgcGFydGljaXBhbnRzIHdobyBtYXkgYmUgbW9yZSBlbmdhZ2VkIG9yIGNlbnRyYWwgdG8gdGhlCiAgICBuZXR3b3JrPyBXaHkgZGlkIHlvdSBzZWxlY3QgdGhvc2UgdHdvPwoKICAgIC0gICAKCjMuICBXaGF0IGVsc2UgZG8geW91IG5vdGljZS93b25kZXIgYWJvdXQgdGhpcyBkYXRhc2V0PwoKICAgIC0gICAKCiMjIDFiLiBJZGVudGlmeSBhIFF1ZXN0aW9uKHMpCgpBIFNvY2lhbCBOZXR3b3JrIFBlcnNwZWN0aXZlIG9uIFBlZXIgU3VwcG9ydGVkIExlYXJuaW5nIGluIE1PT0MtRWRzIHdhcwpmcmFtZWQgYnkgdGhyZWUgcHJpbWFyeSByZXNlYXJjaCBxdWVzdGlvbnMgcmVsYXRlZCB0byBwZWVyIHN1cHBvcnRlZApsZWFybmluZzoKCjEuICBXaGF0IGFyZSB0aGUgcGF0dGVybnMgb2YgcGVlciBpbnRlcmFjdGlvbiBhbmQgdGhlIHN0cnVjdHVyZSBvZiBwZWVyCiAgICBuZXR3b3JrcyB0aGF0IGVtZXJnZSBvdmVyIHRoZSBjb3Vyc2Ugb2YgYSBNT09DLUVkPwoKMi4gIFRvIHdoYXQgZXh0ZW50IGRvIHBhcnRpY2lwYW50IGFuZCBuZXR3b3JrIGF0dHJpYnV0ZXMgKGUuZy4sCiAgICBob21vcGhpbHksIHJlY2lwcm9jaXR5LCB0cmFuc2l0aXZpdHkpIGFjY291bnQgZm9yIHRoZSBzdHJ1Y3R1cmUgb2YKICAgIHRoZXNlIG5ldHdvcmtzPwoKMy4gIFRvIHdoYXQgZXh0ZW50IGRvIHRoZXNlIG5ldHdvcmtzIHJlc3VsdCBpbiB0aGUgY28tY29uc3RydWN0aW9uIG9mCiAgICBuZXcga25vd2xlZGdlPwoKRm9yIG91ciB2ZXJ5IGZpcnN0IHdhbGt0aHJvdWdoLCB3ZSBhcmUgZ29pbmcgdG8gZm9jdXMgZXhjbHVzaXZlbHkgb24gUlExCmZyb20gdGhlIG9yaWdpbmFsIHN0dWR5IGFuZCBvdXIgcXVlc3Rpb24gb2YgaW50ZXJlc3QgYWJvdXQgb3VyIGVkdWNhdG9yCm5ldHdvcmsgaXM6Cgo+IFRvIHdoYXQgZXh0ZW50LCBkaWQgZWR1Y2F0b3JzIGVuZ2FnZSB3aXRoIG90aGVyIHBhcnRpY2lwYW50cyBpbiB0aGUKPiBkaXNjdXNzaW9uIGZvcnVtcz8KCiMjIyAqKvCfkYkgWW91ciBUdXJuKiogKiripLUqKgoKQmFzZWQgb24gd2hhdCB5b3Uga25vdyBhYm91dCBuZXR3b3JrcyBhbmQgdGhlIGNvbnRleHQgc28gZmFyLCB3aGF0IG90aGVyCnJlc2VhcmNoIHF1ZXN0aW9ucyBtaWdodCBhc2sgd2UgYXNrIGluIHRoaXMgY29udGV4dCB0aGF0IGEgc29jaWFsCm5ldHdvcmsgcGVyc3BlY3RpdmUgbWlnaHQgYmUgYWJsZSB0byBhbnN3ZXI/CgpJbiB0aGUgc3BhY2UgYmVsb3csIHR5cGUgYSBicmllZiByZXNwb25zZSB0byB0aGUgZm9sbG93aW5nIHF1ZXN0aW9uczoKClwtCgpXZSdsbCByZXZpc2l0IHlvdXIgcmVzcG9uc2UgdG93YXJkcyB0aGUgZW5kIGFuZCBwcm92aWRlIGFuIG9wcG9ydHVuaXR5CnRvIHJlZmluZSB5b3VyIHJlc2VhcmNoIHF1ZXN0aW9uIGFmdGVyIHlvdSBrbm93IHRoZSBkYXRhIGEgbGl0dGxlCmJldHRlci4KCiMjIDFjLiBMb2FkIExpYnJhcmllcwoKQXMgaGlnaGxpZ2h0ZWQgaW4gW0NoYXB0ZXIgNiBvZiBEYXRhIFNjaWVuY2UgaW4gRWR1Y2F0aW9uIFVzaW5nClJdKGh0dHBzOi8vZGF0YXNjaWVuY2VpbmVkdWNhdGlvbi5jb20vYzA2Lmh0bWwjYzA2cCkgKERTSUVVUik6Cgo+IFBhY2thZ2VzIGFyZSBzaGFyZWFibGUgY29sbGVjdGlvbnMgb2YgUiBjb2RlIHRoYXQgY2FuIGNvbnRhaW4KPiBmdW5jdGlvbnMsIGRhdGEsIGFuZC9vciBkb2N1bWVudGF0aW9uLiBQYWNrYWdlcyBpbmNyZWFzZSB0aGUKPiBmdW5jdGlvbmFsaXR5IG9mIFIgYnkgcHJvdmlkaW5nIGFjY2VzcyB0byBhZGRpdGlvbmFsIGZ1bmN0aW9ucyB0byBzdWl0Cj4gYSB2YXJpZXR5IG9mIG5lZWRzLgoKTGV0J3MgY2hlY2sgdG8gc2VlIHdoaWNoIHBhY2thZ2VzIGhhdmUgYWxyZWFkeSBiZWVuIGxvYWRlZCBpbnRvIG91cgpSU3R1ZGlvIENsb3VkIHdvcmtzcGFjZS4gVGFrZSBhIGxvb2sgYXQgdGhlIHRoZSBGaWxlcywgUGxvdHMsICYgUGFja2FnZXMKUGFuZSBpbiB0aGUgbG93ZXIgcmlnaHQgaGFuZCBjb3JuZXIgb2YgUlN0dWRpbyBDbG91ZCB0byBtYWtlIHN1cmUgdGhlc2UKcGFja2FnZXMgaGF2ZSBiZWVuIGluc3RhbGxlZCBhbmQgbG9hZGVkOgoKIVtdKGltZy9wYWNrYWdlcy1wYW5lLnBuZyl7d2lkdGg9IjkwJSJ9CgpZb3Ugc2hvdWxkIHNlZSBzb21lIGZhbWlsaWFyIHRpZHl0ZXh0IHBhY2thZ2VzIGZyb20gb3VyIFtHZXR0aW5nIFN0YXJ0ZWQKV2Fsa3Rocm91Z2hdKGh0dHBzOi8vc2JrZWxsb2dnLmdpdGh1Yi5pby9lY2ktNTg5L3VuaXQtMC91bml0LTAtd2Fsa3Rocm91Z2guaHRtbCkKbGlrZSB7ZHBseXJ9IGFuZCB7cmVhZHJ9IHdoaWNoIHdlJ2xsIGJlIHVzaW5nIGFnYWluIHNob3J0bHkuIFlvdSBzaG91bGQKYWxzbyBzZWUgYW4gaW1wb3J0YW50IHBhY2thZ2UgY2FsbCB7aWdyYXBofSB0aGF0IHdpbGwgcmVseSBvbiBoZWF2aWx5CmZvciBvdXIgbmV0d29yayBhbmFseXNlcy4KCklmIHlvdSBhcmUgd29ya2luZyBpbiBSU3R1ZGlvIERlc2t0b3AsIG9yIG5vdGljZSB0aGF0IHRoZSBwYWNrYWdlcyBoYXZlCm5vdCBiZWVuIGluc3RhbGxlZCBhbmQvb3IgbG9hZGVkLCBydW4gdGhlIGZvbGxvd2luZyBgaW5zdGFsbC5wYWNrYWdlcygpYApmdW5jdGlvbiBjb2RlIHRvIGluc3RhbGwgdGhlIHt0aWR5dmVyc2V9IGFuZCB7aWdyYXBofSBwYWNrYWdlczoKCmBgYHtyLCBldmFsPUZBTFNFfQppbnN0YWxsLnBhY2thZ2VzKCJ0aWR5dmVyc2UiKQppbnN0YWxsLnBhY2thZ2VzKCJpZ3JhcGgiKSAKYGBgCgpMZXQncyBnbyBhaGVhZCBhbmQgdXNlIGBsaWJyYXJ5KClgIGZ1bmN0aW9uIGZvciB0aGUge3RpZHl2ZXJzZX0gcGFja2FnZQpqdXN0IHRvIHJldmlldyB0aGUgb3RoZXIgcGFja2FnZXMgZnJvbSB0aGUgW3RpZHl2ZXJzZSBjb2xsZWN0aW9uIG9mCnBhY2thZ2VzXShodHRwczovL3d3dy50aWR5dmVyc2Uub3JnKSB0aGF0IHRoaXMgcGFja2FnZSBjb250YWluczoKCmBgYHtyfQpsaWJyYXJ5KHRpZHl2ZXJzZSkKYGBgCgojIyMg8J+OiSBpZ3JhcGggUGFja2FnZSAqKvCfk6YqKgoKIVtdKGltZy9pZ3JhcGgucG5nKXt3aWR0aD0iMzAlIn0KCkZvciBvdXIgVW5pdCAxIFdhbGt0aHJvdWdoLCB3ZSB3aWxsIHJlbHkgaGVhdmlseSBvbiB0aGUgW2lncmFwaCBuZXR3b3JrCmFuYWx5c2lzIHBhY2thZ2VdKGh0dHBzOi8vaWdyYXBoLm9yZykuIFRoZSBtYWluIGdvYWxzIG9mIHRoZSBpZ3JhcGgKcGFja2FnZSBhbmQgdGhlIGNvbGxlY3Rpb24gb2YgbmV0d29yayBhbmFseXNpcyB0b29scyBpdCBjb250YWlucyBhcmUgdG8KcHJvdmlkZSBhIHNldCBvZiBkYXRhIHR5cGVzIGFuZCBmdW5jdGlvbnMgZm9yOgoKMS4gIHBhaW4tZnJlZSBpbXBsZW1lbnRhdGlvbiBvZiBncmFwaCBhbGdvcml0aG1zLAoKMi4gIGZhc3QgaGFuZGxpbmcgb2YgbGFyZ2UgZ3JhcGhzLCB3aXRoIG1pbGxpb25zIG9mIHZlcnRpY2VzIGFuZCBlZGdlcy4KCjMuICBhbGxvd2luZyByYXBpZCBwcm90b3R5cGluZyB2aWEgaGlnaCBsZXZlbCBsYW5ndWFnZXMgbGlrZSBSLgoKUnVuIHRoZSBjb2RlIGNodW5rIGJlbG93IHRvIGxvYWQgdGhlIHtpZ3JhcGhdIGxpYnJhcnk6CgpgYGB7cn0KbGlicmFyeShpZ3JhcGgpCmBgYAoKIyMjICoq8J+RiSBZb3VyIFR1cm4qKiAqKuKktSoqCgpUYWtlIGEgbG9vayBhdCB0aGUgbWVzc2FnZXMgZnJvbSB0aGUgb3V0cHV0IG9mIGFmdGVyIGxvYWRpbmcgdGhlIGlncmFwaApsaWJyYXJ5LiBXaGF0IHRpZHl2ZXJzZSBwYWNrYWdlcyBzaGFyZSBpZGVudGljYWxseSBuYW1lZCBmdW5jdGlvbnMgd2l0aAppZ3JhcGg/CgpXcml0ZSB5b3VyIHJlc3BvbnNlIGluIHRoZSBzcGFjZSBiZWxvdy4KClwtCgojIyMg8J+ntiBLbml0ICYgQ2hlY2sg4pyFCgpDb25ncmF0cyEgWW91IG1hZGUgaXQgdG8gdGhlIGVuZCBvZiBkYXRhIHdyYW5nbGluZyBzZWN0aW9uIGFuZCBhcmUgcmVhZHkKdG8gc3RhcnQgYW5hbHlzaXMhIEJlZm9yZSBwcm9jZWVkaW5nIGZ1cnRoZXIsIGtuaXQgeW91ciBkb2N1bWVudCBhbmQKY2hlY2sgdG8gc2VlIGlmIHlvdSBlbmNvdW50ZXIgYW55IGVycm9ycy4KCi0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQoKIyAyLiBXUkFOR0xFCgpJbiBnZW5lcmFsLCBkYXRhIHdyYW5nbGluZyBpbnZvbHZlcyBzb21lIGNvbWJpbmF0aW9uIG9mIGNsZWFuaW5nLApyZXNoYXBpbmcsIHRyYW5zZm9ybWluZywgYW5kIG1lcmdpbmcgZGF0YSAoV2lja2hhbSAmIEdyb2xlbXVuZCwgMjAxNykuClRoZSBpbXBvcnRhbmNlIG9mIGRhdGEgd3JhbmdsaW5nIGlzIGRpZmZpY3VsdCB0byBvdmVyc3RhdGUsIGFzIGl0Cmludm9sdmVzIHRoZSBpbml0aWFsIHN0ZXBzIG9mIGdvaW5nIGZyb20gdGhlIHJhdyBkYXRhIHRvIGEgZGF0YXNldCB0aGF0CmNhbiBiZSBleHBsb3JlZCBhbmQgbW9kZWxlZCAoS3J1bW0gZXQgYWwsIDIwMTgpLgoKRm9yIG91ciBkYXRhIHdyYW5nbGluZyB0aGlzIHdlZWssIHdlJ3JlIGtlZXBpbmcgaXQgc2ltcGxlIHNpbmNlIHdvcmtpbmcKd2l0aCBuZXR3b3JrIGRhdGEgaXMgYSBiaXQgb2YgYSBkZXBhcnR1cmUgZnJvbSBvdXIgd29ya2luZyB3aXRoCnJlY3Rhbmd1bGFyIGRhdGEgZnJhbWVzLiBPdXIgcHJpbWFyeSBnb2FscyBmb3IgVW5pdCAxIGFyZSBsZWFybmluZyBob3cKdG86CgphLiAgKipJbXBvcnQgRGF0YSoqLiBCZWZvcmUgd29ya2luZyB3aXRoIGRhdGEsIHdlIG5lZWQgdG8gInJlYWQiIGl0IGludG8KICAgIFIgYW5kIG9uY2UgaW1wb3J0ZWQsIHdlJ2xsIHRha2UgYXQgZGlmZmVyZW50IHdheXMgdG8gdmlldyBvdXIgZGF0YQogICAgaW4gUi4KCmIuICAqKkNyZWF0ZSBhIE5ldHdvcmsgT2JqZWN0KiouCgpjLiAgKipTaW1wbGlmeSBOZXR3b3JrKiouIEZpbmFsbHksIHdlJ2xsIGxlYXJuIGFib3V0IGEgaGFuZHkKICAgIGBzaW1wbGlmeSgpYCBmdW5jdGlvbiBpbiB0aGUge2lncmFwaH0gcGFja2FnZSBmb3IgcmVtb3ZpbmcgdGllcyB0aGF0CiAgICAuCgojIyAyYS4gSW1wb3J0IERhdGEKCiMjIyBUaGUgRWRnZS1MaXN0IEZvcm1hdAoKVG8gZ2V0IHN0YXJ0ZWQsIHdlIG5lZWQgdG8gaW1wb3J0LCBvciAicmVhZCIsIG91ciBkYXRhIGludG8gUi4gVGhlCmZ1bmN0aW9uIHVzZWQgdG8gaW1wb3J0IHlvdXIgZGF0YSB3aWxsIGRlcGVuZCBvbiB0aGUgZmlsZSBmb3JtYXQgb2YgdGhlCmRhdGEgeW91IGFyZSB0cnlpbmcgdG8gaW1wb3J0LCBidXQgUiBpcyBwcmV0dHkgYWRlcHQgYXQgd29ya2luZyB3aXRoCm1hbnkgZmlsZXMgdHlwZXMuCgpUYWtlIGEgbG9vayBpbiB0aGUgYC9kYXRhYCBmb2xkZXIgaW4geW91ciBGaWxlcyBwYW5lLiBZb3Ugc2hvdWxkIHNlZSB0aGUKZm9sbG93aW5nIC5jc3YgZmlsZXM6CgotICAgYGRsdDEtZWRnZWxpc3QuY3N2YAoKLSAgIGBkbHQxLW5vZGVzLmNzdmAKCkFzIGl0cyBuYW1lIGltcGxpZXMsIHRoZSBmaXJzdCBmaWxlIGBkbHQxLWVkZ2VsaXN0LmNzdmAgaXMgYW4gZWRnZS1saXN0CnRoYXQgY29udGFpbnMgaW5mb3JtYXRpb24gYWJvdXQgZWFjaCB0aWUsIG9yIHJlbGF0aW9uIGJldHdlZW4gdHdvIGFjdG9ycwppbiBhIG5ldHdvcmsuIEluIHRoaXMgY29udGV4dCwgYSAidGllIiBpcyBhIHJlcGx5IGJ5IG9uZSBwYXJ0aWNpcGFudCBpbgp0aGUgZGlzY3Vzc2lvbiBmb3J1bSB0byB0aGUgcG9zdCBvZiBhbm90aGVyIHBhcnRpY2lwYW50IC0gb3IgaW4gc29tZQpjYXNlcyB0byB0aGVpciBvd24gcG9zdCEgVGhlc2UgdGllcyBiZXR3ZWVuIGEgc2luZ2xlIGFjdG9yIGFyZSBjYWxsZWQKInNlbGYtbG9vcHMiIGFuZCBhcyB3ZSdsbCBzZWUgbGF0ZXIgaW4gdGhpcyBzZWN0aW9uLCBpZ3JhcGggaGFzIGEKc3BlY2lhbCBmdW5jdGlvbiB0byByZW1vdmUgdGhlc2Ugc2VsZiBsb29wcyBmcm9tIGEgc29jaW9ncmFtLCBvciBuZXR3b3JrCnZpc3VhbGl6YXRpb24uCgpUaGUgZWRnZS1saXN0IGZvcm1hdCBpcyBzbGlnaHRseSBkaWZmZXJlbnQgdGhhbiBvdGhlciBmb3JtYXRzIHlvdSBoYXZlCmxpa2VseSB3b3JrZWQgd2l0aCBiZWZvcmUgaW4gdGhhdCB0aGUgdmFsdWVzIGluIHRoZSBmaXJzdCB0d28gY29sdW1ucwplYWNoIHJvdyByZXByZXNlbnQgYSBkeWFkLCBvciB0aWUgYmV0d2VlbiB0d28gbm9kZXMgaW4gYSBuZXR3b3JrLiBBbgplZGdlLWxpc3QgY2FuIGFsc28gY29udGFpbiBvdGhlciBpbmZvcm1hdGlvbiByZWdhcmRpbmcgdGhlIHN0cmVuZ3RoLApkdXJhdGlvbiwgb3IgZnJlcXVlbmN5IG9mIHRoZSByZWxhdGlvbnNoaXAsIHNvbWV0aW1lIGNhbGxlZCAid2VpZ2h0IiwgaW4KYWRkaXRpb24gdG8gb3RoZXIgImVkZ2UgYXR0cmlidXRlcy4iCgpJbiBhZGRpdGlvbiB0bwoKLSAgIGBTZW5kZXJgID0gVW5pcXVlIGlkZW50aWZpZXIgb2YgYXV0aG9yIG9mIGNvbW1lbnQKCi0gICBgUmVjZWl2ZXJgID0gVW5pcXVlIGlkZW50aWZpZXIgb2YgaWRlbnRpZmllZCByZWNpcGllbnQgb2YgY29tbWVudAoKLSAgIGBUaW1lc3RhbXBgID0gVGltZSBjb21tZW50IHdhcyBwb3N0ZWQKCi0gICBgUGFyZW50YCA9IFByaW1hcnkgY2F0ZWdvcnkgb3IgdG9waWMgb2YgdGhyZWFkCgotICAgYENhdGVnb3J5YCA9IFN1YmNhdGVnb3J5IG9yIHN1YnRvcGljIG9mIHRocmVhZAoKLSAgIGBUaHJlYWRfaWRgID0gVW5pcXVlIGlkZW50aWZpZXIgb2YgYSB0aHJlYWQKCi0gICBgQ29tbWVudF9pZGAgPSBVbmlxdWUgaWRlbnRpZmllciBvZiBhIGNvbW1lbnRcXAoKTGV0J3MgdXNlIHRoZSBgcmVhZF9jc3YoKWAgZnVuY3Rpb24gZnJvbSB0aGUge3JlYWRyfSBwYWNrYWdlIGludHJvZHVjZWQKaW4gdGhlIEdldHRpbmcgU3RhcnRlZCB3YWxrdGhyb3VnaCB0byByZWFkIGluIG91ciBlZGdlLWxpc3QgYW5kIHByaW50CnRoZSBuZXcgYHRpZXNgIGRhdGEgZnJhbWU6CgpgYGB7cn0KdGllcyA8LSByZWFkX2NzdigiZGF0YS9kbHQxLWVkZ2VsaXN0LmNzdiIsIAogICAgICAgICAgICAgICAgIGNvbF90eXBlcyA9IGNvbHMoU2VuZGVyID0gY29sX2NoYXJhY3RlcigpLCAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIFJlY2VpdmVyID0gY29sX2NoYXJhY3RlcigpLCAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIGBDYXRlZ29yeSBUZXh0YCA9IGNvbF9za2lwKCksIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgYENvbW1lbnQgSURgID0gY29sX2NoYXJhY3RlcigpLCAKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIGBEaXNjdXNzaW9uIElEYCA9IGNvbF9jaGFyYWN0ZXIoKSkpCgp0aWVzCmBgYAoKTm90ZSB0aGUgYWRkaXRpb24gb2YgdGhlIGBjb2xfdHlwZXMgPWAgYXJndW1lbnQgZm9yIGNoYW5naW5nIHRoZSBjb2x1bW4KdHlwZXMgdG8gY2hhcmFjdGVyIHN0cmluZ3Mgc2luY2UgdGhlIG51bWJlcnMgZm9yIGZvciB0aG9zZSBwYXJ0aWN1bGFyCmNvbHVtbnMgaW5kaWNhdGUgYWN0b3JzIChgU2VuZGVyYCBhbmQgYFJlY2lldmVyYCkgYW5kIGF0dHJpYnV0ZXMKKGBDb21tZW50X0lEYCBhbmQgYERpc2N1c3Npb25fSWRgKS4gV2UgYWxzbyBza2lwcGVkIHRoZSBgQ2F0ZWdvcnkgVGV4dGAuCgoqKlJTdHVkaW8gVGlwOioqIEltcG9ydGluZyBkYXRhIGFuZCBkZWFsaW5nIHdpdGggZGF0YSB0eXBlcyBjYW4gYmUgYSBiaXQKdHJpY2t5LCBlc3BlY2lhbGx5IGZvciBiZWdpbm5lcnMuIEZvcnR1bmF0ZWx5LCBSU3R1ZGlvIGhhcyBhbiAiSW1wb3J0CkRhdGFzZXQiIGZlYXR1cmUgaW4gdGhlIEVudmlyb25tZW50IFBhbmUgdGhhdCBjYW4gaGVscCB5b3UgdXNlIHRoZQp7cmVhZHJ9IHBhY2thZ2UgYW5kIGFzc29jaWF0ZWQgZnVuY3Rpb25zIHRvIGdyZWF0bHkgZmFjaWxpdGF0ZSB0aGlzCnByb2Nlc3MuCgohW10oaW1nL2ltcG9ydC1kYXRhLnBuZykKCiMjIyAqKvCfkYkgWW91ciBUdXJuKiogKiripLUqKgoKQ29uc2lkZXIgdGhlIGV4YW1wbGUgcGljdHVyZWQgYmVsb3cgb2YgYSBkaXNjdXNzaW9uIHRocmVhZCBmcm9tIHRoZQpQbGFubmluZyBmb3IgdGhlIERpZ2l0YWwgTGVhcm5pbmcgVHJhbnNpdGlvbiBpbiBLLTEyIFNjaG9vbHMgKERMVCAxKQp3aGVyZSBvdXIgZGF0YSBvcmdpbmF0ZWQuIFRoaXMgdGhyZWFkIHdhcyBpbml0aWF0ZWQgYnkgcGFydGljaXBhbnQgSSwgc28KdGhlIGNvbW1lbnRzIGJ5IEogYW5kIE4gYXJlIGNvbnNpZGVyZWQgdG8gYmUgZGlyZWN0ZWQgYXQgSS4gVGhlIGNvbW1lbnQKb2YgQiwgaG93ZXZlciwgaXMgYSBkaXJlY3QgcmVzcG9uc2UgdG8gdGhlIGNvbW1lbnQgYnkgTiBhcyBzaWduYWxlZCBieQp0aGUgdXNlIG9mIHRoZSBxdW90ZS1mZWF0dXJlIGFzIHdlbGwgYXMgdGhlIGV4cGxpY2l0IG1lbnRpb25pbmcgb2YgTidzCm5hbWUgd2l0aGluIEIncyBjb21tZW50LgoKIVtdKGltZy9kaXNjdXNzaW9uLXRocmVhZC5wbmcpCgpOb3cgYW5zd2VyIHRoZSBmb2xsb3dpbmcgcXVlc3Rpb25zIGFzIHRoZXkgcmVsYXRlIHRvIHRoZSBETFQgMSBlZGdlLWxpc3QKd2UganVzdCByZWFkIGludG8gUi4KCjEuICBXaGljaCBhY3RvcnMgaW4gdGhpcyB0aHJlYWQgYXJlIHRoZSBgU2VuZGVyYCBhbmQgdGhlIGBSZWNpZXZlcmA/CiAgICBXaGljaCBhY3RvciBpcyBib3RoPwoKICAgIC0gICAKCjIuICBIb3cgbWFueSBkeWFkcyBhcmUgaW4gdGhpcyB0aHJlYWQ/IFdoaWNoIHBhaXJzIG9mIGFjdG9ycyBhcmUgZHlhZHM/CgogICAgLSAgIAoKKipTaWRlYmFyOioqIFVuZm9ydHVuYXRlbHksIHRoZXNlIHR5cGVzIG9mIG51YW5jZXMgaW4gZGlzY3Vzc2lvbiBmb3J1bQpkYXRhIGFzIGlsbHVzdHJhdGVkIGJ5IHRoaXMgc2ltcGxlIGV4YW1wbGUgYXJlIHJhcmVseSBjYXB0dXJlZCB0aHJvdWdoCmF1dG9tYXRlZCBhcHByb2FjaGVzIHRvIGNvbnN0cnVjdGluZyBuZXR3b3Jrcy4gRm9ydHVuYXRlbHksIHRoZSBkYXRhc2V0CnlvdSBhcmUgd29ya2luZyB3aXRoIHdhcyBjYXJlZnVsbHkgcmV2aWV3ZWQgdG8gdHJ5IGFuZCBjYXB0dXJlIG1vcmUKYWNjdXJhdGVseSB0aGUgaW50ZW5kZWQgcmVjaXBpZW50cyBvZiBlYWNoIHJlcGx5LgoKIyMjIE5vZGUgQXR0cmlidXRlcwoKVGhlIHNlY29uZCBmaWxlIGlzIHdlJ2xsIGJlIHVzaW5nIHRvIGhlbHAgdW5kZXJzdGFuZCBvdXQgbmV0d29yayBhbmQgdGhlCmFjdG9ycyBpbnZvbHZlZCBjb250YWlucyBhbGwgdGhlIG5vZGVzIG9yIGFjdG9ycyAoaS5lLiwgcGFydGljaXBhbnRzIHdobwpwb3N0ZWQgdG8gdGhlIGRpc2N1c3Npb24gZm9ydW0pIGFzIHdlbGwgYXMgc29tZSBvZiB0aGVpciBhdHRyaWJ1dGVzIHN1Y2gKYXMgZ2VuZGVyIGFuZCB5ZWFycyBvZiBleHBlcmllbmNlIGluIGVkdWNhdGlvbi4KCkNhcm9seW4gKDIwMTMpIG5vdGVzIHRoYXQgbW9zdCBzb2NpYWwgbmV0d29yayBhbmFseXNlcyBpbmNsdWRlIHZhcmlhYmxlcwp0aGF0IGRlc2NyaWJlIGF0dHJpYnV0ZXMgb2YgYWN0b3JzLCBvbmVzIHRoYXQgYXJlIGVpdGhlciBjYXRlZ29yaWNhbAooZS5nLiwgc2V4LCByYWNlLCBldGMuKSBvciBjb250aW51b3VzIGluIG5hdHVyZSAoZS5nLiwgdGVzdCBzY29yZXMsCm51bWJlciBvZiB0aW1lcyBhYnNlbnQsIGV0Yy4pLiBUaGVzZSBhdHRyaWJ1dGVzIHRoYXQgY2FuIGJlIGluY29ycG9yYXRlZAppbnRvIGEgbmV0d29yayBncmFwaCBvciBtb2RlbCB0byBtYWtpbmcgaXQgbXVjaCBtb3JlIGluZm9ybWF0aXZlIGFuZCBjYW4KYWlkIGluIHRlc3Rpbmcgb3IgZ2VuZXJhdGluZyBoeXBvdGhlc2VzLgoKVGhlc2UgYXR0cmlidXRlIHZhcmlhYmxlcyBhcmUgdHlwaWNhbGx5IGluY2x1ZGVkIGluIGEgcmVjdGFuZ3VsYXIgYXJyYXksCm9yIGRhdGFmcmFtZSwgdGhhdCBtaW1pY3MgdGhlIGFjdG9yLWJ5LWF0dHJpYnV0ZSB0aGF0IGlzIHRoZSBkb21pbmFudApjb252ZW50aW9uIGluIHNvY2lhbCBzY2llbmNlLCBpLmUuIHJvd3MgcmVwcmVzZW50IGNhc2VzLCBjb2x1bW5zCnJlcHJlc2VudCB2YXJpYWJsZXMsIGFuZCBjZWxscyBjb25zaXN0IG9mIHZhbHVlcyBvbiB0aG9zZSB2YXJpYWJsZXMuCgpBcyBhbmQgYXNpZGUsIENhcm9seW4gYWxzbyByZWZlcnMgdG8gdGhpcyBoaXN0b3JpY2FsIHByZWZlcmVuY2UgYnkKcmVzZWFyY2hlcnMgZm9yICJhY3Rvci1ieS1hdHRyaWJ1dGUiIGRhdGEsIGluIHRoZSBhYnNlbmNlIG9mIHJlbGF0aW9uYWwKZGF0YSBpbiB3aGljaCB0aGUgYWN0b3IgaGFzIGJlZW4gcmVtb3ZlZCB0aGVpciBzb2NpYWwgY29udGV4dCwgYXMgdGhlCiJzb2Npb2xvZ2ljYWwgbWVhdGdyaW5kZXIiIGluIGFjdGlvbi4gU3BlY2lmaWNhbGx5LCB0aGlzIGhpc3RvcmljYWwKYXBwcm9hY2ggYXNzdW1lcyB0aGF0IHRoZSBhY3RvciBkb2VzIG5vdCBpbnRlcmFjdCB3aXRoIGFueW9uZSBlbHNlIGluCnRoZSBzdHVkeSBhbmQgdGhhdCBvdXRjb21lcyBhcmUgc29sZWx5IGRlcGVuZGVudCBvZiB0aGUgY2hhcmFjdGVyaXN0aWNzCm9mIHRoZSBpbmRpdmlkdWFsLgoKUmVnYXJkbGVzcywgbGV0J3MgcmVhZCBpbiBvdXIgbm9kZSBhdHRyaWJ1dGUgZmlsZSBhbmQgdGFrZSBhIGxvb2sgYXQgdGhlCmBhY3RvcnNgIGFuZCB0aGVpciBhdHRyaWJ1dGVzIGluY2x1ZGVkIGluIG91ciBkYXRhc2V0OgoKYGBge3J9CmFjdG9ycyA8LSByZWFkX2NzdigiZGF0YS9kbHQxLW5vZGVzLmNzdiIsIAogICAgICAgICAgICAgICAgICAgY29sX3R5cGVzID0gY29scyhVSUQgPSBjb2xfY2hhcmFjdGVyKCksIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBGYWNpbGl0YXRvciA9IGNvbF9jaGFyYWN0ZXIoKSwgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIGV4cGVydCA9IGNvbF9jaGFyYWN0ZXIoKSwgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIGNvbm5lY3QgPSBjb2xfY2hhcmFjdGVyKCkpKQpgYGAKCiMjIyAqKvCfkYkgWW91ciBUdXJuKiogKiripLUqKgoKVXNlIHRoZSBjb2RlIGNodW5rIGJlbG93IGFuZCBhIGZ1bmN0aW9uIG9mIHlvdXIgY2hvb3NpbmcgdG8gdGFrZSBhIGxvb2sKYXQgdGhlIGBhY3RvcnNgIGRhdGEgZnJhbWU6CgpgYGB7cn0KCmBgYAoKTWF0Y2ggdXAgdGhlIGF0dHJpYnV0ZXMgaW5jbHVkZWQgaW4gdGhlIG5vZGUgZmlsZSB3aXRoIHRoZSBmb2xsb3dpbmcKY29kZWJvb2sgZGVzY3JpcHRvcnMuIFRoZSBmaXJzdCBvbmUgaGFzIGJlZW4gZG9uZSBhcyBhbiBleGFtcGxlLgoKLSAgIGBGYWNpbGl0YXRvcmAgPSBJZGVudGlmaWNhdGlvbiBvZiBjb3Vyc2UgZmFjaWxpdGF0b3IgKDEgKio9KioKICAgIGluc3RydWN0b3IpCi0gICBEdW1teSB2YXJpYWJsZSBmb3Igd2hldGhlciBwYXJ0aWNpcGFudHMgbGlzdGVkCiAgICBuZXR3b3JraW5nL2NvbGxhYm9yYXRpb24gd2l0aCBvdGhlcnMgYXMgb25lIG9mIHRoZWlyIGNvdXJzZSBnb2FscyBvbgogICAgdGhlIHJlZ2lzdHJhdGlvbiBmb3JtCi0gICBJZGVudGlmaWVyIG9mICJleHBlcnQgcGFuZWxpc3RzIiBpbnZpdGVkIHRvIGNvdXJzZSB0byBzaGFyZQogICAgZXhwZXJpZW5jZSB0aHJvdWdoIHJlY29yZGVkIFEmQQotICAgSWRlbnRpZmljYXRpb24gb2YgY291cnNlIGZhY2lsaXRhdG9yICgxICoqPSoqIGluc3RydWN0b3IpCi0gICBQcm9mZXNzaW9uYWwgcm9sZSAoZWcsIHRlYWNoZXIsIGxpYnJhcmlhbiwgYWRtaW5pc3RyYXRvcikKLSAgIFllYXJzIG9mIGV4cGVyaWVuY2UgYXMgYW4gZWR1Y2F0b3IKLSAgIFdvcmtzIHdpdGggZWxlbWVudGFyeSwgbWlkZGxlLCBhbmQvb3IgaGlnaCBzY2hvb2wgc3R1ZGVudHMKLSAgIEluaXRpYWwgYXNzaWdubWVudCBvZiBkaXNjdXNzaW9uIGdyb3VwCgojIyAyYi4gQ3JlYXRlIE5ldHdvcmsgT2JqZWN0CgpCZWZvcmUgd2UgY2FuIGJlZ2luIHVzaW5nIG1hbnkgb2YgdGhlIGZ1bmN0aW9ucyBmcm9tIHRoZSB7aWdyYXBofSBmb3IKc3VtbWFyaXppbmcgYW5kIHZpc3VhbGl6aW5nIG91ciBETFQgMSBuZXR3b3JrLCB3ZSBmaXJzdCBuZWVkIHRvIGNvbnZlcnQKdGhlIGRhdGEgZnJhbWVzIHRoYXQgd2UgaW1wb3J0ZWQgaW50byBhbiBpZ3JhcGggbmV0d29yayBvYmplY3QsIG9yIGFuCmlncmFwaCBncmFwaC4KCiMjIyBDb252ZXJ0IHRvIGlncmFwaCBHcmFwaAoKVG8gZG8gdGhhdCwgd2Ugd2lsbCB1c2UgdGhlIGBncmFwaF9mcm9tX2RhdGFfZnJhbWUoKWAgZnVuY3Rpb24uIE5vdGUKdGhhdCBJIGluY2x1ZGVkIHRoZSBgZXZhbD1GQUxTRWAgYXJndW1lbnQgaW4gdGhlIGNvZGUgYmxvY2sgYmVsb3cgdG8KcHJldmVudCB0aGlzIGNvZGUgZnJvbSBydW5uaW5nIHdoZW4gd2Uga25pdCBvdXIgZmluYWwgZG9jdW1lbnQuCk90aGVyd2lzZSBpdCB3aWxsIHByb2R1Y2UgYW4gZXJyb3Igc2luY2Ugd2UgY2FuJ3QgaW5jbHVkZSBoZWxwCmRvY3VtZW50YXRpb24gaW4gb3VyIGtuaXR0ZWQgSFRNTCBmaWxlLgoKUnVuIHRoZSBmb2xsb3dpbmcgY29kZSB0byB0YWtlIGEgbG9vayBhdCB0aGUgaGVscCBkb2N1bWVudGF0aW9uIGZvciB0aGlzCmZ1bmN0aW9uOgoKYGBge3IsIGV2YWw9RkFMU0V9Cj9ncmFwaF9mcm9tX2RhdGFfZnJhbWUKYGBgCgpZb3UgcHJvYmFibHkgc2F3IHRoYXQgdGhpcyBwYXJ0aWN1bGFyIGZ1bmN0aW9uIHRha2VzIHRoZSBmb2xsb3dpbmcgdGhyZWUKYXJndW1lbnRzLCB0d28gb2Ygd2hpY2ggYXJlIGRhdGEgZnJhbWVzOgoKLSAgICoqZCoqwqBkZXNjcmliZXMgdGhlIGVkZ2VzIG9mIHRoZSBuZXR3b3JrLiBUaGUgZmlyc3QgdHdvIGNvbHVtbnMgYXJlCiAgICB0aGUgSURzIG9mIHRoZSBzb3VyY2UgYW5kIHRoZSB0YXJnZXQgbm9kZSBmb3IgZWFjaCBlZGdlLCBpbiBvdXIgY2FzZQogICAgdGhlIGBTZW5kZXJgIGFuZCBgUmV2aWV2ZXJgIG9mIGEgZGlzY3Vzc2lvbiBwb3N0LiBUaGUgb3JkZXIgbWF0dGVycyEKICAgIFRoZSBmb2xsb3dpbmcgY29sdW1ucyBhcmUgZWRnZSBhdHRyaWJ1dGVzIHN1Y2ggYXMgd2VpZ2h0LCB0eXBlLAogICAgbGFiZWwsIG9yIGFueXRoaW5nIGVsc2UuCgotICAgKip2ZXJ0aWNlcyoqwqBzdGFydHMgd2l0aCBhIGNvbHVtbiBvZiBub2RlIElEcyBhbmQgYW55IGZvbGxvd2luZwogICAgY29sdW1ucyBhcmUgaW50ZXJwcmV0ZWQgYXMgbm9kZSBhdHRyaWJ1dGVzLgoKLSAgICoqZGlyZWN0ZWQqKiBpcyBkZXRlcm1pbmVzIHdoZXRoZXIgb3Igbm90IHRvIGNyZWF0ZSBhIGRpcmVjdGVkCiAgICBncmFwaC4KClJ1biB0aGUgZm9sbG93aW5nIGNvZGUgdG8gc3BlY2lmeSBvdXIgYHRpZXNgIGRhdGEgZnJhbWUgYXMgdGhlIGVkZ2VzIG9mCm91ciBuZXR3b3JrLCBvdXIgYGFjdG9yc2AgZGF0YSBmcmFtZSBmb3IgdGhlIHZlcnRpY2VzIG9mIG91ciBuZXR3b3JrIGFuZAp0aGVpciBhdHRyaWJ1dGVzLCBhbmQgaW5kaWNhdGUgdGhhdCB0aGlzIGlzIGluZGVlZCBhIGRpcmVjdGVkIG5ldHdvcmsuCgpgYGB7cn0KbmV0d29yayA8LSBncmFwaF9mcm9tX2RhdGFfZnJhbWUoZCA9IHRpZXMsIAogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB2ZXJ0aWNlcyA9IGFjdG9ycywgCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIGRpcmVjdGVkID0gVCkgCgpuZXR3b3JrCmBgYAoKQ2Fyb2x5biAoMjAxMykgcmVtaW5kcyB1cyB0aGF0IG9uZSBvZiB0aGUgc2ltcGxlc3QgYW5kIG9mdGVuIGlnbm9yZWQKc3RydWN0dXJhbCBwcm9wZXJ0eSBvZiBhIHNvY2lhbCBuZXR3b3JrIGlzIGl0cyBzaXplIGFuZCBleHBsYWlucyB0aGF0OgoKPiAqKnNpemUqKiBpcyBzaW1wbHkgYSBtZWFzdXJlIG9mIHRoZSBudW1iZXIgb2Ygbm9kZXMgaW4gdGhlIG5ldHdvcmsuCgpIZSBub3RlcyB0aGF0IHRoZSBzaXplIG9mIGEgbmV0d29yayBwbGF5cyBhbiBpbXBvcnRhbnQgcm9sZSBpbgpkZXRlcm1pbmluZyB3aGF0IGhhcHBlbnMgaW4gdGhlIG5ldHdvcmsuIEZvciBleGFtcGxlLCBpbiBhIGNsYXNzcm9vbSBvZgozMCBzdHVkZW50cywgaXQgaXMgbm90IGhhcmQgdG8gaW1hZ2luZSB0aGF0IHRoZSBwYXR0ZXJuIG9mIHdobwpjb21tdW5pY2F0ZXMgd2l0aCB3aG9tIHdpbGwgbG9vayBtdWNoIGRpZmZlcmVudCB0aGFuIGlmIHRoZSBuZXR3b3JrCmNvbnNpc3RlZCBvZiBodW5kcmVkcyBvciBldmVuIHRob3VzYW5kcyBvZiBzdHVkZW50cyBsaWtlIGluIGEgTU9PQy4KCiMjIyAqKvCfkYkgWW91ciBUdXJuKiogKiripLUqKgoKVGFrZSBhIGxvb2sgYXQgdGhlIHZlcnkgZmlyc3QgbGluZSBvZiB0aGUgb3V0cHV0IHdoaWNoIGNvbnRhaW5zIHNvbWUKYmFzaWMgaW5mb3JtYXRpb24gYWJvdXQgb3VyIG5ldHdvcmsgYW5kIGFuc3dlciB0aGUgZm9sbG93aW5nIHF1ZXN0aW9uczoKCjEuICBIb3cgbWFueSBub3RlcyBhbmQgZWRnZXMgYXJlIGluIG91ciBuZXR3b3JrPyBJcyB0aGlzIGNvbnNpc3RlbnQgd2l0aAogICAgdGhlIG51bWJlciBvZiBvYnNlcnZhdGlvbnMgaW4gb3VyIGRhdGEgZnJhbWVzPyAqKkhpbnQ6KiogQ2hlY2sgdGhlCiAgICBFbnZpcm9ubWVudCBwYW5lLgoKICAgIC0gICAKCjIuICBUaGUgIkQiIGFuZCB0aGUgIk4iIGluZGljYXRlIHRoYXQgdGhpcyBpcyBhICoqRCoqaXJlY3RlZCBuZXR3b3JrIGFuZAogICAgaGFzIHRoZSAqKk4qKmFtZSB2ZXJ0ZXggYXR0cmlidXRlcyBzZXQuIFdoeSBkbyB0aGUgdHdvIHNwYWNlcyB0aGF0CiAgICBmb2xsb3cgdGhlc2UgbGV0dGVycyBoYXZlIGRhc2hlcz8gKipIaW50OioqIGNoZWNrIHRoZSBoZWxwIGZpbGVzLgoKICAgIC0gICAKCjMuICBXaGljaCB2ZXJ0ZXggYXR0cmlidXRlIGRpZCBpZ3JhcGggaW50ZXJwcmV0IGFzIG51bWVyaWM/CgogICAgLSAgIAoKIyMjIFNpbXBsaWZ5IEdyYXBoCgpBcyB5b3Ugc2F3IGZyb20gdGhlIGBuZXR3b3JrYCBvdXRwdXQsIG91ciBkYXRhc2V0IGhhcyAyNTI5IGVkZ2VzIG9yIHRpZXMKYW5kIGp1c3QgYSBxdWljayBzY2FuIG9mIHRoZSBlZGdlcyBpbiB0aGUgbmV0d29yayBzaG93cyB0aGF0IGVkZ2VzIGxpa2UKMzU2IC1cPiA0NDQgb2NjdXIgYXQgbGVhc3QgbW9yZSB0aGFuIG9uY2UuIFNvIHdlIGtub3cgdGhhdCBwYXJ0aWNpcGFudAozNTYgaGFzIHJlcGxpZWQgdG8gcGFydGljaXBhbnQgNDQ0IGF0IGxlYXN0IHR3aWNlLgoKRm9ydHVuYXRlbHksIHRoZSB7aWdyYXBofSBwYWNrYWdlIGhhcyBhIGBzaW1wbGlmeSgpYCBmdW5jdGlvbiBmb3IKY29sbGFwc2luZyB0aGVzZSBkdXBsaWNhdGUgZWRnZXMgc28gdGhleSBhcmUgbm90IHJlcHJlc2VudGVkIG1vcmUgdGhhbgpvbmNlIHdoZW4gd2Ugd2FudCB2aXN1YWxseSBkZXBpY3Qgb3VyIG5ldHdvcmsgd2l0aCBhIHNvY2lvZ3JhbS4KCkxldCdzIHVzZSB0aGF0IGZ1bmN0aW9uIHRvIHNpbXBsaWZ5IG91ciBuZXR3b3JrIGFuZCBzYXZlIGl0IGFzIGEKYHNpbXBsZV9uZXR3b3JrLGAgb3IgYSBzaW1wbGUgZ3JhcGgsIHdoaWNoIGNvbnRhaW5zIG5vIHNlbGYtbG9vcHMgb3IKZHVwbGljYXRlIGVkZ2VzIGFuZCB3aGljaCBieSBkZWZhdWx0IHRoZSBgc2ltcGxpZnkoKWAgZnVuY3Rpb24gcmVtb3ZlczoKCmBgYHtyfQpzaW1wbGVfbmV0d29yayA8LSBzaW1wbGlmeShuZXR3b3JrKQoKc2ltcGxlX25ldHdvcmsKYGBgCgojIyMgKirwn5GJIFlvdXIgVHVybioqICoq4qS1KioKClRha2UgYSBsb29rIGF0IHRoZSBvdXRwdXQgZm9yIG91ciBzaW1wbGUgZ3JhcGggbm93IGFuZCBhbnN3ZXIgdGhlCmZvbGxvd2luZyBxdWVzdGlvbnM6CgoxLiAgSG93IG1hbnkgdW5pcXVlIGVkZ2VzIGFyZSBpbiB0aGUgbmV0d29yaz8KCiAgICAtICAgCgoyLiAgRGlkIHdlIGxvc2UgYW55IGltcG9ydGFudCBvciBwb3RlbnRpYWxseSB1c2VmdWwgaW5mb3JtYXRpb24gYnkKICAgIGNvbGxhcHNpbmcgbXVsdGlwbGUgZWRnZXMgaW50byBhIHNpbmdsZSBlZGdlPwoKICAgIC0gICAKCiMjIyBBZGQgRWRnZSBXZWlnaHRzCgpXZSBub3RlZCBlYXJsaWVyIHRoYXQgZWRnZXMgY2FuIGFsc28gY29udGFpbiBhdHRyaWJ1dGVzIHN1Y2ggYXMKc3RyZW5ndGgsIGR1cmF0aW9uIG9yIGZyZXF1ZW5jeSwgc29tZXRpbWUgY2FsbGVkICJ3ZWlnaHQuIiBUaGVzZSB3ZWlnaHRzCmNhbiBub3Qgb25seSBoZWxwIHVzIGJldHRlciB1bmRlcnN0YW5kIHRoZSByZWxhdGlvbnNoaXAgYmV0d2VlbiB0d28KYWN0b3JzLCBidXQgYWxzbyBhaWQgaW4gdmlzdWFsaXphdGlvbiBhbmQgbW9kZWxpbmcgbGF0ZXIgb24uCgpXaGVuIHdlIHVzZWQgdGhlIGBzaW1wbGlmeSgpYCBmdW5jdGlvbiBlYXJsaWVyLCBpdCBjb2xsYXBzZWQgb3VyCmR1cGxpY2F0ZSBlZGdlcyBidXQgd2UgbG9zdCBzb21lIHZpdGFsIGluZm9ybWF0aW9uIGFzIGEgcmVzdWx0LCBuYW1lbHkKdGhlIGZyZXF1ZW5jeSBvZiByZXBsaWVzIGFtb25nIHBhaXJzIG9mIGVkdWNhdG9ycyBpbiBvdXIgZGlzY3Vzc2lvbgpmb3J1bS4KCkZvcnR1bmF0ZWx5LCB0aGUgYHNpbXBsaWZ5KClgIGZ1bmN0aW9uIGNvbnRhaW5zIGFuIGFyZ3VtZW50IHRoYXQgd2lsbAphbGxvdyB1cyB0byBjb3VudCB0aGUgbnVtYmVyIG9mIHRpZXMgYmV0d2VlbiB0d28gYWN0b3JzLCBzaW1pbGFyIHRvIGhvdwp3ZSBtaWdodCB1c2UgdGhlIGBjb3VudCgpYCBmdW5jdGlvbiBpbiB0aGUge2RwbHlyfSBwYWNrYWdlIGxpa2Ugc286CgpgYGB7cn0KZWRnZV93ZWlnaHRzIDwtIGNvdW50KHRpZXMsIFNlbmRlciwgUmVjZWl2ZXIpCgplZGdlX3dlaWdodHMKYGBgCgpJbiB0aGlzIGNhc2UsIHdlIHNlZSB0aGF0IHBhcnRpY2lwYW50IDEgcmVwbGllZCB0byBwYXJ0aWNpcGFudCAxNDQgdHdpY2UKdGhyb3VnaG91dCB0aGUgY291cnNlLgoKVG8gYWRkIHdlaWdodHMgdG8gb3VyIHNpbXBsaWZpZWQgbmV0d29yaywgd2UgZmlyc3QgbmVlZCB0byBhZGQgYQpgd2VpZ2h0YCB2YXJpYWJsZSB0byB0aGUgZWRnZXMgaW4gb3VyIG9yaWdpbmFsIGBuZXR3b3JrYCBpZ3JhcGggb2JqZWN0LgoKVGhlIHtpZ3JhcGh9IHBhY2thZ2UgaGFzIGEgdW5pcXVlIHN5bnRheCBmb3Igd29ya2luZyB3aXRoIGF0dHJpYnV0ZXMgb2YKbmV0d29yayBvYmplY3RzLiBUbyBhZGQgYSB3ZWlnaHQgYXR0cmlidXRlIHRvIHRoZSBgRSgpYCBlZGdlcyBpbiBvdXIKYG5ldHdvcmtgIHdlJ2xsIHVzZSB0aGUgYCRgIG9wZXJhdG9yIHdoaWNoIGNhbiBiZSB1c2VkIHRvIGNyZWF0ZSBhIG5ldwpgd2VpZ2h0YCB2YXJpYWJsZSAtLSBvciBzZWxlY3QgYSB2YXJpYWJsZSBhcyB3ZSdsbCBzZWUgbGF0ZXIgb24gLS0gYW5kCnVzZSB0aGUgYDwtYCBhc3NpZ25tZW50IG9wZXJhdG9yIHRvIGFkZCBhbiBpbml0aWFsIHZhbHVlIG9mIGAxYCBmb3IgdGhlCndlaWdodCBvZiBlYWNoIGVkZ2UuCgpMZXQncyBwdXQgdGhhdCBhbGwgdG9nZXRoZXIgYW5kIHJ1biB0aGUgY29kZSB0byBhZGQgYSB3ZWlnaHQgb2YgMSB0bwplYWNoIGVkZ2UgaW4gb3VyIG5ldHdvcmsKCmBgYHtyfQpFKG5ldHdvcmspJHdlaWdodCA8LSAxICAKYGBgCgpOb3cgbGV0J3MgdGFrZSBhIGxvb2sgYXQgb3VyIGlncmFwaCBuZXR3b3JrIG9iamVjdCBhZ2FpbjoKCmBgYHtyfQpuZXR3b3JrCmBgYAoKV2UgY2FuIHNlZSB0aGF0IG91ciBuZXR3b3JrIGlzIG5vdyB3ZWlnaHRlZCBhcyBpbmRpY2F0ZWQgYnkgdGhlICJXIiBhbmQKdGhhdCBvdXIgbmV3IGB3ZWlnaHRgIGF0dHJpYnV0ZSBoYXMgYmVlbiBhZGRlZC4KCmBgYHtyfQp3ZWlnaHRlZF9uZXR3b3JrIDwtIHNpbXBsaWZ5KG5ldHdvcmssCiAgICAgICAgICAgICAgICAgICAgICAgICAgIGVkZ2UuYXR0ci5jb21iID0gbGlzdCh3ZWlnaHQ9InN1bSIpCiAgICAgICAgICAgICAgICAgICAgICAgICAgICkKYGBgCgpcCgpgYGB7ciwgZXZhbD1GQUxTRX0Kd2VpZ2h0ZWRfbmV0d29yawpgYGAKCiMjIyAqKvCfkYkgWW91ciBUdXJuKiogKiripLUqKgoKIyMjIPCfp7YgS25pdCAmIENoZWNrIOKchQoKQ29uZ3JhdHMhIFlvdSBtYWRlIGl0IHRvIHRoZSBlbmQgb2YgZGF0YSB3cmFuZ2xpbmcgc2VjdGlvbiBhbmQgYXJlIHJlYWR5CnRvIHN0YXJ0IGFuYWx5c2lzISBCZWZvcmUgcHJvY2VlZGluZyBmdXJ0aGVyLCBrbml0IHlvdXIgZG9jdW1lbnQgYW5kCmNoZWNrIHRvIHNlZSBpZiB5b3UgZW5jb3VudGVyIGFueSBlcnJvcnMuCgotLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KCiMgMy4gRVhQTE9SRQoKQXMgaGlnaGxpZ2h0ZWQgaW4gYm90aCBEU0VJVVIgYW5kIExlYXJuaW5nIEFuYWx5dGljcyBHb2VzIHRvIFNjaG9vbCwKY2FsY3VsYXRpbmcgc3VtbWFyeSBzdGF0aXN0aWNzLCBkYXRhIHZpc3VhbGl6YXRpb24sIGFuZCBmZWF0dXJlCmVuZ2luZWVyaW5nICh0aGUgcHJvY2VzcyBvZiBjcmVhdGluZyBuZXcgdmFyaWFibGVzIGZyb20gYSBkYXRhc2V0KSBhcmUgYQprZXkgcGFydCBvZiBleHBsb3JhdG9yeSBkYXRhIGFuYWx5c2lzLiBPbmUgZ29hbCBpbiB0aGlzIHBoYXNlIGlzIGV4cGxvcmUKcXVlc3Rpb25zIHRoYXQgZHJvdmUgdGhlIG9yaWdpbmFsIGFuYWx5c2lzIGFuZCBkZXZlbG9wIG5ldyBxdWVzdGlvbnMgYW5kCmh5cG90aGVzZXMgdG8gdGVzdCBpbiBsYXRlciBzdGFnZXMuCgpJbiBTZWN0aW9uIDMsIHdlIHdpbGwgbGVhcm4gc29tZSBuZXcgZnVuY3Rpb25zIGZvciByZXRyaWV2aW5nIGJhc2ljCm5ldHdvcmsgZGVzY3JpcHRpdmVzIHJlbGF0ZWQgdG8gb3VyIHJlc2VhcmNoIHF1ZXN0aW9uIGFuZCBjcmVhdGUgYQpuZXR3b3JrIHZpc3VhbGl6YXRpb24gdG8gaGVscCBpbGx1c3RyYXRlIGtleSBmaW5kaW5ncy4gU3BlY2lmaWNhbGx5LAp0aGlzIHNlY3Rpb24gd2UnbGwgbGVhcm4gdG86CgphLiAgKipFeGFtaW5lIEJhc2ljIERlc2NyaXB0aXZlcyoqLiBXZSBmb2N1cyBwcmltYXJpbHkgb24gYWN0b3JzIGFuZAogICAgZWRnZXMgaW4gdGhpcyB3YWxrdGhyb3VnaCwgaW5jbHVkaW5nIHRoZSBlZGdlcyB3aWdodHMgd2UgYWRkZWQgaW4KICAgIHRoZSBwcmV2aW91cyBzZWN0aW9uIGFzIHdlbGwgYXMgbm9kZSBkZWdyZWUsIGFuZCBpbXBvcnQgYW5kIGZhaXJseQogICAgaW50dWl0aXZlIG1lYXN1cmUgb2YgY2VudHJhbGl0eS4KCmIuICAqKk1ha2UgYSBTb2Npb2dyYW0qKi4gRmluYWxseSwgd2Ugd3JhcCB1cCB0aGUgZXhwbG9yZSBwaGFzZXMgYnkKICAgIGxlYXJuaW5nIHRvIHBsb3QgYSBuZXR3b3JrIGFuZCB0d2VhayBrZXkgZWxlbWVudHMgbGlrZSB0aGUgc2l6ZSwKICAgIHNoYXBlLCBhbmQgcG9zaXRpb24gb2Ygbm9kZXMgYW5kIGVkZ2VzIHRvIGJldHRlciBhdCBjb21tdW5pY2F0aW5nCiAgICBrZXkgZmluZGluZ3MuCgojIyAzYS4gRXhhbWluZSBCYXNpYyBEZXNjcmlwdGl2ZXMKCiMjIyBFZGdlIFdlaWdodHMKClwKCmBgYHtyfQptZWFuKGVkZ2Vfd2VpZ2h0cyRuKQptZWRpYW4oZWRnZV93ZWlnaHRzJG4pCmhpc3QoZWRnZV93ZWlnaHRzJG4sIGJyZWFrcyA9IDEwKQoKYGBgCgpOb3cgdGhhdCB3ZSd2ZSBsb29rZWQgYXQgdGhlIHR5cGljYWwgZnJlcXVlbmN5IG9mIHRob3NlCgojIyMgTm9kZSBEZWdyZWUKCkEga2V5IHN0cnVjdHVyYWwgcHJvcGVydHkgb2YgbmV0d29ya3MgaXMgdGhlIGNvbmNlcHQgb2YgY2VudHJhbGl6YXRpb24uCkEgbmV0d29yayB0aGF0IGlzIGhpZ2hseSBjZW50cmFsaXplZCBpcyBvbmUgaW4gd2hpY2ggcmVsYXRpb25zIGFyZQpmb2N1c2VkIG9uIGEgc21hbGwgbnVtYmVyIG9mIGFjdG9ycyBvciBldmVuIGEgc2luZ2xlIGFjdG9yIGluIGEgbmV0d29yaywKd2hlcmVhcyB0aWVzIGluIGEgZGVjZW50cmFsaXplZCBuZXR3b3JrIGFyZSBkaWZmdXNlIGFuZCBzcHJlYWQgb3ZlciBhCm51bWJlciBvZiBhY3RvcnMuIE9uZSBvZiB0aGUgbW9zdCBjb21tb24gbWVhc3VyZSBvZiBjZW50cmFsaXphdGlvbiBpcwpkZWdyZWUKCj4gKipEZWdyZWUqKiBpcyB0aGUgbnVtYmVyIG9mIHRpZXMgdG8gYW5kIGZyb20gYW4gZWdvLiBJbiBhIGRpcmVjdGVkCj4gbmV0d29yaywgaW4tZGVncmVlIGlzIHRoZSBudW1iZXIgb2YgdGllcyByZWNlaXZlZCwgd2hlcmVhcyBvdXQtZGVncmVlCj4gaXMgdGhlIG51bWJlciBvZiB0aWVzIHNlbnQuCgpUaGUge2lncmFwaH0gcGFja2FnZSBoYXMgYW4gYXB0bHkgbmFtZWQgZnVuY3Rpb24gYGRlZ3JlZSgpYCBmb3IKcmV0cmlldmluZyBkZWdyZWUsIGluLWRlZ3JlZSwgYW5kIG91dC1kZWdyZWUgZm9yIGFsbCBhY3RvcnMgaW4gYQpuZXR3b3JrLgoKUnVuIHRoZSBmb2xsb3dpbmcgY29kZSB0byBleHRyYWN0IG1lYXN1cmVzIGFuZCBzYXZlIHRvIGBub2RlX2RlZ3JlZWAKd2hpY2ggd2UnbGwgZXhhbWluZSBpbiBqdXN0IGEgYml0OgoKYGBge3J9Cm5vZGVfZGVncmVlIDwtIGRlZ3JlZSh3ZWlnaHRlZF9uZXR3b3JrLCBtb2RlID0gImFsbCIpCmBgYAoKTm90ZSB0aGF0IHdlIHNldCB0aGUgYG1vZGUgPWAgYXJndW1lbnQgaW4gdGhpcyBmdW5jdGlvbiB0byAiYWxsIiB3aGljaApnaXZlIHVzIHRoZSB0b3RhbCBudW1iZXIgb2YgcGFydGljaXBhbnRzIHRoYXQgZWFjaCBhY3RvciBpbiBvdXIgbmV0d29yawp3aXRoIHNlbnQgb3IgcmVjZWl2ZWQgYSByZXBseS4KCkxldCdzIHRha2UgYSBsb29rIGF0IHRoZSBkaXN0cmlidXRpb24gb2YgYG5vZGVfZGVncmVlYCBpbiBvdXIgbmV0d29yayBieQp1c2luZyBSJ3MgYnVpbHQgaW4gYGhpc3QoKWAgZnVuY3Rpb24gZm9yIGNyZWF0aW5nIGhpc3RvZ3JhbXMuIEkgc2V0IHRoZQp2YWx1ZSBvZiBgYnJlYWtzID1gLCBvciBiaW5zIGluIG91ciBoaXN0b2dyYW0sIHRvIDMwIHNpbmNlIEkgYWxyZWFkeQprbm93IHNvbWUgYWN0b3JzIGluIHRoaXMgbmV0d29yayBoYXZlIGEgdmVyeSBoaWdoIGRlZ3JlZS4KCmBgYHtyfQpoaXN0KG5vZGVfZGVncmVlLCBicmVha3MgPSAzMCkKYGBgCgpXZSBjYW4gc2VlIHRoYXQgbW9zdCBhY3RvcnMgaW4gdGhlIG5ldHdvcmsgYXJlIGNvbm5lY3RlZCB0byB2ZXJ5IGZldwppbmRpdmlkdWFscyB3aGlsZSBhIGNvdXBsZSBhY3RvcnMgaW4gdGhpcyBuZXR3b3JrIGFyZSBjb25uZWN0ZWQgdG8gYQp2ZXJ5IGxhcmdlciBudW1iZXIgb2YgYWx0ZXJzLgoKTm93IGxldCdzIHRha2UgYSBsb29rIGF0IHRoZSBtZWFuIGFuZCBtZWRpYW4gZm9yIGBub2RlX2RlZ3JlZWAgdXNpbmcKc29tZSBvdGhlciB7YmFzZX0gUiBmdW5jdGlvbnM6CgpgYGB7cn0KbWVhbihub2RlX2RlZ3JlZSkKbWVkaWFuKG5vZGVfZGVncmVlKQpgYGAKCldlIHNlZSB0aGF0IHRoZSBtZWFuIHN1Z2dlc3RzIHRoZSBwYXJ0aWNpcGFudHMgYXJlLCBvbiBhdmVyYWdlLApjb25uZWN0ZWQgdG8gYWJvdXQgOCBvdGhlciBwYXJ0aWNpcGFudHMgaW4gdGhlIE1PT0MtRWQsIGJ1dCB0aGlzIGlzCmxpa2VseSBoZWF2aWx5IHNrZXdlZCBieSB0aGUgdHdvIGluZGl2aWR1YWxzIHdpdGggYSBkaXNwcm9wb3J0aW9uYXRlCm51bWJlciBvZiBjb25uZWN0aW9ucy4gVGhlIG1lZGlhbiBpcyBwcm9iYWJseSBhIGJldHRlciBjaGFyYWN0ZXJpemF0aW9uCm9mIHRoZSB0eXBpY2FsIG51bWJlciBvZiBlZHVjYXRvcnMgYSBwYXJ0aWNpcGFudCBoYXMgc2VudCBvciByZWNlaXZlZCBhCnJlcGx5LgoKIyMjIyBJbi1EZWdyZWUKCkxldCdzIGdvIGFoZWFkIGFuZCB0YWtlIGEgbG9vayBhdCBpbi1kZWdyZWUgbmV4dDoKCmBgYHtyfQppbl9kZWdyZWUgPC0gZGVncmVlKHdlaWdodGVkX25ldHdvcmssIG1vZGU9ImluIikKCmhpc3QoaW5fZGVncmVlLCBicmVha3MgPSAzMCkKbWVhbihpbl9kZWdyZWUpCm1lZGlhbihpbl9kZWdyZWUpCmBgYAoKXAoKIyMjICoq8J+RiSBZb3VyIFR1cm4qKiAqKuKktSoqCgpVc2UgdGhlIGNvZGUgY2h1bmsKCmBgYHtyfQoKYGBgCgpJbiB0aGUgc3BhY2UgYmVsb3csIHdyaXRlIHlvdXIgaW50ZXJwcmV0YXRpb24gb2YgdGhlc2UgcmVzdWx0cy4KClwtCgpcCgojIyAzYi4gTWFrZSBhIFNvY2lvZ3JhbQoKaWdyYXBoIGFyZ3VtZW50cyBvbmx5XAoKYGBge3J9CnBsb3Qod2VpZ2h0ZWRfbmV0d29yaykKYGBgCgpIYWlyIGJhbGwKCiMjIyMgUmVtb3ZlIExhYmVscwoKYGBge3J9CnBsb3Qod2VpZ2h0ZWRfbmV0d29yaywKICAgICB2ZXJ0ZXgubGFiZWwgPSBOQSkKYGBgCgpcCgojIyMjIENoYW5nZSB2ZXJ0ZXggc2l6ZQoKYGBge3J9CnBsb3Qod2VpZ2h0ZWRfbmV0d29yaywKICAgICB2ZXJ0ZXgubGFiZWwgPSBOQSwKICAgICB2ZXJ0ZXguc2l6ZSA9IDEpCmBgYAoKXApkZWdyZWUKCmBgYHtyfQpwbG90KHdlaWdodGVkX25ldHdvcmssCiAgICAgdmVydGV4LmxhYmVsID0gTkEsCiAgICAgdmVydGV4LnNpemUgPSBub2RlX2RlZ3JlZSkKYGBgCgpcCgpgYGB7cn0KcGxvdCh3ZWlnaHRlZF9uZXR3b3JrLAogICAgIHZlcnRleC5sYWJlbCA9IE5BLAogICAgIHZlcnRleC5zaXplID0gbm9kZV9kZWdyZWUqLjEpCmBgYAoKXAoKIyMjIyBSZWR1Y2UgYXJyb3cgc2l6ZQoKXAoKYGBge3J9CnBsb3Qod2VpZ2h0ZWRfbmV0d29yaywKICAgICB2ZXJ0ZXgubGFiZWwgPSBOQSwKICAgICB2ZXJ0ZXguc2l6ZSA9IG5vZGVfZGVncmVlKi4xLAogICAgIGVkZ2UuYXJyb3cuc2l6ZSA9IC4wNCkKYGBgCgojIyMjIEFkanVzdCBFZGdlIFdpZHRoCgpgYGB7cn0KcGxvdCh3ZWlnaHRlZF9uZXR3b3JrLAogICAgIHZlcnRleC5sYWJlbCA9IE5BLAogICAgIHZlcnRleC5zaXplID0gbm9kZV9kZWdyZWUqLjA1LAogICAgIGVkZ2UuYXJyb3cuc2l6ZSA9IC4wNCwKICAgICBlZGdlLndpZHRoID0gLjIpCmBgYAoKXApcCgpgYGB7cn0KcGxvdCh3ZWlnaHRlZF9uZXR3b3JrLAogICAgIHZlcnRleC5sYWJlbCA9IE5BLAogICAgIHZlcnRleC5zaXplID0gbm9kZV9kZWdyZWUqLjEsCiAgICAgZWRnZS5hcnJvdy5zaXplID0gLjA0LAogICAgIGVkZ2Uud2lkdGggPSBFKHdlaWdodGVkX25ldHdvcmspJHdlaWdodCkKYGBgCgpcCgpgYGB7cn0KcGxvdCh3ZWlnaHRlZF9uZXR3b3JrLAogICAgIHZlcnRleC5sYWJlbCA9IE5BLAogICAgIHZlcnRleC5zaXplID0gbm9kZV9kZWdyZWUqLjA1LAogICAgIGVkZ2UuYXJyb3cuc2l6ZSA9IC4wNSwKICAgICBlZGdlLndpZHRoID0gRSh3ZWlnaHRlZF9uZXR3b3JrKSR3ZWlnaHQvNSkKYGBgCgpcCgojIyMjIENoYW5nZSBMYXlvdXQKClwKCmBgYHtyfQpwbG90KHdlaWdodGVkX25ldHdvcmssCiAgICAgdmVydGV4LmxhYmVsID0gTkEsCiAgICAgdmVydGV4LnNpemUgPSBub2RlX2RlZ3JlZSouMDUsCiAgICAgZWRnZS5hcnJvdy5zaXplID0gLjA1LAogICAgIGVkZ2Uud2lkdGggPSBFKHdlaWdodGVkX25ldHdvcmspJHdlaWdodC81LAogICAgIGxheW91dCA9IGxheW91dF93aXRoX2ZyKQpgYGAKClwKCmBgYHtyfQpwbG90KHdlaWdodGVkX25ldHdvcmssCiAgICAgdmVydGV4LmxhYmVsID0gTkEsCiAgICAgdmVydGV4LnNpemUgPSBub2RlX2RlZ3JlZSouMDUsCiAgICAgZWRnZS5hcnJvdy5zaXplID0gLjA1LAogICAgIGVkZ2Uud2lkdGggPSBFKHdlaWdodGVkX25ldHdvcmspJHdlaWdodC81LAogICAgIGxheW91dCA9IGxheW91dF93aXRoX2trKQoKYGBgCgpcCgpgYGB7cn0KCnBsb3Qod2VpZ2h0ZWRfbmV0d29yaywKICAgICB2ZXJ0ZXgubGFiZWwgPSBOQSwKICAgICB2ZXJ0ZXguc2l6ZSA9IG5vZGVfZGVncmVlKi4wNSwKICAgICBlZGdlLmFycm93LnNpemUgPSAuMDUsCiAgICAgZWRnZS53aWR0aCA9IEUod2VpZ2h0ZWRfbmV0d29yaykkd2VpZ2h0LzUsCiAgICAgbGF5b3V0ID0gbGF5b3V0X2luX2NpcmNsZSkKCmBgYAoKIyMjICoq8J+RiSBZb3VyIFR1cm4qKiAqKuKktSoqCgpXZSd2ZSBvbmx5IHNjcmF0Y2hlZCB0aGUgc3VyZmFjZSBvZiB3aGF0J3MgcG9zc2libGUgd2l0aCBuZXR3b3JrCnBsb3R0aW5nIGJ1dCBob3BlZnVsbHkgdGhpcyBoYXZlIGdpdmVuIHlvdSBhIHNlbnNlIG9mCgpgYGB7cn0KCmBgYAoKIyMjIPCfp7YgS25pdCAmIENoZWNrIOKchQoKQ29uZ3JhdHMhIFlvdSBtYWRlIGl0IHRvIHRoZSBlbmQgb2YgdGhlIEV4cGxvcmUgc2VjdGlvbiBhbmQgYXJlIHJlYWR5IHRvCmxlYXJuIGEgbGl0dGxlIGFib3V0IG5ldHdvcmsgbW9kZWxpbmchIEJlZm9yZSBwcm9jZWVkaW5nIGZ1cnRoZXIsIGtuaXQKeW91ciBkb2N1bWVudCBhbmQgY2hlY2sgdG8gc2VlIGlmIHlvdSBlbmNvdW50ZXIgYW55IGVycm9ycy4KCiMgNC4gTU9ERUwKCkFzIGhpZ2hsaWdodGVkIGluwqBbQ2hhcHRlciAzIG9mIERhdGEgU2NpZW5jZSBpbiBFZHVjYXRpb24gVXNpbmcKUl0oaHR0cHM6Ly9kYXRhc2NpZW5jZWluZWR1Y2F0aW9uLmNvbS9jMDMuaHRtbCksIHRoZcKgKipNb2RlbCoqwqBzdGVwIG9mCnRoZSBkYXRhIHNjaWVuY2UgcHJvY2VzcyBlbnRhaWxzICJ1c2luZyBzdGF0aXN0aWNhbCBtb2RlbHMsIGZyb20gc2ltcGxlCnRvIGNvbXBsZXgsIHRvIHVuZGVyc3RhbmQgdHJlbmRzIGFuZCBwYXR0ZXJucyBpbiB0aGUgZGF0YS4iIFRoZSBhdXRob3JzCm5vdGUgdGhhdCB3aGlsZSBkZXNjcmlwdGl2ZSBzdGF0aXN0aWNzIGFuZCBkYXRhIHZpc3VhbGl6YXRpb24gZHVyaW5nCnRoZcKgKipFeHBsb3JlKiogc3RlcCBjYW4gaGVscCB1cyB0byBpZGVudGlmeSBwYXR0ZXJucyBhbmQgcmVsYXRpb25zaGlwcwppbiBvdXIgZGF0YSwgc3RhdGlzdGljYWwgbW9kZWxzIGNhbiBiZSB1c2VkIHRvIGhlbHAgdXMgZGV0ZXJtaW5lIGlmCnJlbGF0aW9uc2hpcHMsIHBhdHRlcm5zIGFuZCB0cmVuZHMgYXJlIGFjdHVhbGx5IG1lYW5pbmdmdWwuCgpXZSB3aWxsIG5vdCBleHBsb3JlIHRoZSB1c2Ugb2YgbW9kZWxzIGZvciBTTkEgdW50aWwgVW5pdCAzLCByZWNhbGwgZnJvbQp0aGUgUFJFUEFSRSBzZWN0aW9uIHRoYXQgdGhlIEtlbGxvZ2cgZXQgYWwuIHN0dWR5IHdhcyBndWlkZWQgYnkgdGhlCmZvbGxvd2luZyBxdWVzdGlvbnM6CgoxLiAgV2hhdCBhcmUgdGhlIHBhdHRlcm5zIG9mIHBlZXIgaW50ZXJhY3Rpb24gYW5kIHRoZSBzdHJ1Y3R1cmUgb2YgcGVlcgogICAgbmV0d29ya3MgdGhhdCBlbWVyZ2Ugb3ZlciB0aGUgY291cnNlIG9mIGEgTU9PQy1FZD8KCjIuICBUbyB3aGF0IGV4dGVudCBkbyBwYXJ0aWNpcGFudCBhbmQgbmV0d29yayBhdHRyaWJ1dGVzIChlLmcuLAogICAgaG9tb3BoaWx5LCByZWNpcHJvY2l0eSwgdHJhbnNpdGl2aXR5KSBhY2NvdW50IGZvciB0aGUgc3RydWN0dXJlIG9mCiAgICB0aGVzZSBuZXR3b3Jrcz8KCjMuICBUbyB3aGF0IGV4dGVudCBkbyB0aGVzZSBuZXR3b3JrcyByZXN1bHQgaW4gdGhlIGNvLWNvbnN0cnVjdGlvbiBvZgogICAgbmV3IGtub3dsZWRnZT8KClRvIGFkZHJlc3MgUXVlc3Rpb24gMSwgYWN0b3JzIGluIHRoZSBuZXR3b3JrIHdlcmUgY2F0ZWdvcml6ZWQgaW50bwpkaXN0aW5jdCBtdXR1YWxseSBleGNsdXNpdmUgZ3JvdXBzIHVzaW5nIHRoZSBjb3JlLXBlcmlwaGVyeSBhbmQgcmVndWxhcgplcXVpdmFsZW5jZSBmdW5jdGlvbnMgb2YgVUNJTkVULiBUaGUgZm9ybWVyIHVzZWQgdGhlIENPUlIgYWxnb3JpdGhtIHRvCmRpdmlkZSB0aGUgbmV0d29yayBpbnRvIGFjdG9ycyB0aGF0IGFyZSBwYXJ0IG9mIGEgZGVuc2VseSBjb25uZWN0ZWQKc3ViZ3JvdXAsIG9yICJjb3JlIiwgZnJvbSB0aG9zZSB0aGF0IGFyZSBwYXJ0IG9mIHRoZSBzcGFyc2VseSBjb25uZWN0ZWQKcGVyaXBoZXJ5LiBSZWd1bGFyIGVxdWl2YWxlbmNlIGVtcGxveXMgdGhlIFJFR0UgYmxvY2ttb2RlbGluZyBhbGdvcml0aG0KdG8gcGFydGl0aW9uLCBvciBncm91cCwgYWN0b3JzIGluIHRoZSBuZXR3b3JrIGJhc2VkIG9uIHRoZSBzaW1pbGFyaXR5IG9mCnRoZWlyIHRpZXMgdG8gb3RoZXJzIHdpdGggc2ltaWxhciB0aWVzLiBJbiBlc3NlbmNlLCBibG9ja21vZGVsaW5nCnByb3ZpZGVzIGEgc3lzdGVtYXRpYyB3YXkgZm9yIGNhdGVnb3JpemluZyBlZHVjYXRvcnMgYmFzZWQgb24gdGhlIHdheXMKaW4gd2hpY2ggdGhleSBpbnRlcmFjdGVkIHdpdGggcGVlcnMuCgpBcyB3ZSBzYXcgdXBvbiBqdXN0IGEgYmFzaWMgdmlzdWFsIGluc3BlY3Rpb24gb2Ygb3VyIG5ldHdvcmsgZHVyaW5nIHRoZQpFeHBsb3JlIHNlY3Rpb24sIHRoZXJlIHdhcyBhIHNtYWxsIGNvcmUgb2YgaGlnaGx5IGNvbm5lY3RlZCBwYXJ0aWNpcGFudHMKc3Vycm91bmRlZCBieSB0aG9zZSBvbiB0aGUgInBlcmlwaGVyeSwiIG9yIGVkZ2UsIG9mIHRoZSBuZXR3b3JrIHdpdGgKdmVyeSBmZXcgY29ubmVjdGlvbnMuIEluIHRoZSBETFQgMiBjb3Vyc2UsIHRob3NlIG9uIHRoZSBwZXJpcGhlcnkgbWFkZQp1cCByb3VnaGx5IDkwJSBvZiBuZXR3b3JrLiBUaGUgc3R1ZHkgYWxzbyBmb3VuZCByZWxhdGl2ZWx5IGhpZ2ggbGV2ZWxzCm9mIHJlY2lwcm9jYXRpb24sIGJ1dCBhbHNvIGZvdW5kIHRoYXQgcm91Z2hseSBhIHF1YXJ0ZXIgb2YgcGFydGljaXBhbnRzCndlcmUgY2hhcmFjdGVyaXplZCBhcyAiYnJvZGNhc3RlcnMiIC0tIGVkdWNhdG9ycyB3aG8gaW5pdGlhdGVkIGEKZGlzY3Vzc2lvbiB0aHJlYWQsIGJ1dCBuZWl0aGVyIHJlY2lwcm9jYXRlZCB3aXRoIHRob3NlIHdobyByZXBsaWVkLCBub3IKcG9zdGVkIHRvIHRocmVhZHMgaW5pdGlhdGVkIGJ5IG90aGVycy4KClRvIGFkZHJlc3MgUXVlc3Rpb24gMiwgdGhpcyBzdHVkeSB1c2UgdGhlIGV4cG9uZW50aWFsIGZhbWlseSBvZiByYW5kb20KZ3JhcGggbW9kZWxzIChFUkdNOyBhbHNvIGtub3duIGFzIHBcKiBtb2RlbHMpLCB3aGljaCBwcm92aWRlIGEKc3RhdGlzdGljYWwgYXBwcm9hY2ggdG8gbmV0d29yayBtb2RlbGluZyB0aGF0IGFkZHJlc3NlcyB0aGUgY29tcGxleApkZXBlbmRlbmNpZXMgd2l0aGluIG5ldHdvcmtzLiBFUkdNcyBwcmVkaWN0IG5ldHdvcmsgdGllcyBhbmQgZGV0ZXJtaW5lCnRoZSBzdGF0aXN0aWNhbCBsaWtlbGlob29kIG9mIGEgZ2l2ZW4gbmV0d29yayBzdHJ1Y3R1cmUsIGJhc2VkIG9uIGFuCmFzc3VtZWQgZGVwZW5kZW5jeSBzdHJ1Y3R1cmUsIHRoZSBhdHRyaWJ1dGVzIG9mIHRoZSBpbmRpdmlkdWFscyAoZS5nLiwKZ2VuZGVyLCBwb3B1bGFyaXR5LCBsb2NhdGlvbiwgcHJldmlvdXMgdGllcykgYW5kIHByaW9yIHN0YXRlcyBvZiB0aGUKbmV0d29yay4KCiMjIyAqKvCfkYkgWW91ciBUdXJuKiogKiripLUqKgoKUmVjYWxsIGZyb20gdGhlIFsxYS4gUmV2aWV3IHRoZSBSZXNlYXJjaF0gdGhhdCB5b3Ugd2VyZSBhc2tlZCB0bwppZGVudGlmeSB0d28gIm5vZGUgYXR0cmlidXRlcyIgZnJvbSB0aGUgZGF0YXNldCB0aGF0IG1pZ2h0IGJlIHVzZWZ1bCBmb3IKcHJlZGljdGluZyBwYXJ0aWNpcGFudHMgd2hvIG1heSBiZSBtb3JlIGVuZ2FnZWQgb3IgY2VudHJhbCB0byB0aGUKbmV0d29yay4KClRha2UgbG9vayBhdCBwYWdlIDI3NiBvZiB0aGUgYXJ0aWNsZSwgW0Egc29jaWFsIG5ldHdvcmsgcGVyc3BlY3RpdmUgb24KcGVlciBzdXBwb3J0ZWQgbGVhcm5pbmcgaW4gTU9PQ3MgZm9yCmVkdWNhdG9yc10oaHR0cHM6Ly9naXRodWIuY29tL3Nia2VsbG9nZy9lY2ktNTg5L2Jsb2IvbWFpbi91bml0LTEvbGl0L3NuYV9tb29jX2lycm9kbF9iamV0X2FydGljbGVzLnBkZikuCldlcmUgeW91ciBwcmVkaWN0aW9ucyBjb3JyZWN0PwoKXC0KClwtCgotLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KCiMgNS4gQ09NTVVOSUNBVEUKClRoZSBmaW5hbCBzdGVwIGluIG91ciB3b3JrZmxvdy9wcm9jZXNzIGlzIHNoYXJpbmcgdGhlIHJlc3VsdHMgb2YKYW5hbHlzaXMgd2l0aCB3aWRlciBhdWRpZW5jZS4gS3J1bW0gZXQgYWwuwqAoMjAxOCkgaGF2ZSBvdXRsaW5lIHRoZQpmb2xsb3dpbmcgMy1zdGVwIHByb2Nlc3MgZm9yIGNvbW11bmljYXRpbmcgd2l0aCBlZHVjYXRpb24gc3Rha2Vob2xkZXJzCndoYXQgeW91IGhhdmUgbGVhcm5lZCB0aHJvdWdoIGFuYWx5c2lzOgoKMS4gICoqU2VsZWN0KiouIENvbW11bmljYXRpbmcgd2hhdCBvbmUgaGFzIGxlYXJuZWQgaW52b2x2ZXMgc2VsZWN0aW5nCiAgICBhbW9uZyB0aG9zZSBhbmFseXNlcyB0aGF0IGFyZSBtb3N0IGltcG9ydGFudCBhbmQgbW9zdCB1c2VmdWwgdG8gYW4KICAgIGludGVuZGVkIGF1ZGllbmNlLCBhcyB3ZWxsIGFzIHNlbGVjdGluZyBhIGZvcm0gZm9yIGRpc3BsYXlpbmcgdGhhdAogICAgaW5mb3JtYXRpb24sIHN1Y2ggYXMgYSBncmFwaCBvciB0YWJsZSBpbiBzdGF0aWMgb3IgaW50ZXJhY3RpdmUgZm9ybSwKICAgIGkuZS7CoGEgImRhdGEgcHJvZHVjdC4iCgoyLiAgKipQb2xpc2gqKi4gQWZ0ZXIgY3JlYXRpbmcgaW5pdGlhbCB2ZXJzaW9ucyBvZiBkYXRhIHByb2R1Y3RzLAogICAgcmVzZWFyY2ggdGVhbXMgb2Z0ZW4gc3BlbmQgdGltZSByZWZpbmluZyBvciBwb2xpc2hpbmcgdGhlbSwgYnkKICAgIGFkZGluZyBvciBlZGl0aW5nIHRpdGxlcywgbGFiZWxzLCBhbmQgbm90YXRpb25zIGFuZCBieSB3b3JraW5nIHdpdGgKICAgIGNvbG9ycyBhbmQgc2hhcGVzIHRvIGhpZ2hsaWdodCBrZXkgcG9pbnRzLgoKMy4gICoqTmFycmF0ZSoqLiBXcml0aW5nIGEgbmFycmF0aXZlIHRvIGFjY29tcGFueSB0aGUgZGF0YSBwcm9kdWN0cwogICAgaW52b2x2ZXMsIGF0IGEgbWluaW11bSwgcGFpcmluZyBhIGRhdGEgcHJvZHVjdCB3aXRoIGl0cyByZWxhdGVkCiAgICByZXNlYXJjaCBxdWVzdGlvbiwgZGVzY3JpYmluZyBob3cgYmVzdCB0byBpbnRlcnByZXQgdGhlIGRhdGEKICAgIHByb2R1Y3QsIGFuZCBleHBsYWluaW5nIHRoZSB3YXlzIGluIHdoaWNoIHRoZSBkYXRhIHByb2R1Y3QgaGVscHMKICAgIGFuc3dlciB0aGUgcmVzZWFyY2ggcXVlc3Rpb24uCgpOZXh0IHdlZWsgd2UnbGwgdGFrZSBhIGxvb2sgYXQgcmVmaW5pbmcgb3VyIGFuYWx5c2lzIGFuZCB3YXlzIHdlIG1pZ2h0CmNvbW11bmljYXRlIGFuZCBzaGFyZSBmaW5kaW5ncyB3aXRoIGVkdWNhdGlvbiBzdGFrZWhvbGRlcnMuCgojIyMgKirwn5GJIFlvdXIgVHVybioqICoq4qS1KioKCk5vdyB0aGF0IHlvdSd2ZSBiZWNvbWUgbW9yZSBmYW1pbGlhciB3aXRoIHRoaXMgZGF0YXNldCBhbmQgdGhlIHNvY2lhbApuZXR3b3JrIHBlcnNwZWN0aXZlLCB3aGF0IG90aGVyIGFzcGVjdHMgb2YgdGhpcyBkYXRhc2V0LCBvciBhIGRhdGFzZXQKeW91IGFyZSBpbnRlcmVzdGVkIGluIGV4cGxvcmluZywgY291bGQgeW91IGludmVzdGlnYXRlPwoKXC0KCldoYXQgc3BlY2lmaWMgcmVzZWFyY2ggcXVlc3Rpb25zIG1pZ2h0IHlvdSBhc2sgdGhhdCB3b3VsZCBiZSBoZWxwZnVsIGZvcgpiZWluZyB1bmRlcnN0YW5kaW5nIGFuZCBpbXByb3ZpbmcgbGVhcm5pbmcsIG9yIHRoZSBjb250ZXh0IGluIHdoaWNoIHRoZQpkYXRhIGlzIGNvbGxlY3RlZD8KClwtCgojIyMg8J+ntiBLbml0ICYgQ2hlY2sg4pyFCgpDb25ncmF0cyEgWW91J3ZlIGZpbmlzaGVkIHRoZSBVbml0IDEgR3VpZGVkIFdhbGt0aHJvdWdoIGFuZCBhcmUgcmVhZHkKZm9yIHNvbWUgaW5kZXBlbmRlbnQgYW5hbHlzaXMgbmV4dCB3ZWVrIQoKVG8gY29tcGxldGUgdGhpcyBhc3NpZ25tZW50LCBrbml0IHlvdXIgZG9jdW1lbnQgYW5kIHNlbmQgbWUgYW4gZW1haWwgYXQKc2JrZWxsb2dcQG5jc3UuZWR1IGxldHRpbmcgbWUga25vdyB5b3UncmUgYWxsIHNldC4K